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Conversion  Factors, 
Non-SI  to  SI  Units  of 
Measurement 


Non-SI  units  of  measurement  used  in  this  report  can  be  converted  to  SI  units 
as  follows: 


Multiply 

By 

To  Obtain 

cubic  tact 

0.02832 

cubic  meters 

degrees 

0.01745 

radians 

fMt 

0.3048 

maters 

inches 

2.540 

centimeters 

square  Met 

0.09290 

square  meters 

1  Introduction 


Background 

STREMR  is  a  computer  code  (numerical  model)  that  generates  discrete 
solutions  of  the  incompressible  Navier- Stokes  equations  for  depth-averaged  (or 
width-averaged)  two-dimensional  (2-D)  flow.  The  present  version  runs  on 
machines  ranging  from  personal  computers  to  supercomputers.  It  is  suitable 
for  routine  use  by  field  engineers  and  others  with  an  interest  in  depth-averaged 
flow  modeling.  Previous  experience  with  numerical  models  is  helpful  but  not 
mandatory  for  first-time  users.  STREMR  can  be  used  as  a  training  aid  for 
prospective  modelers,  as  a  handy  means  of  qualitative  flow  visualization,  and 
as  a  practical  device  for  quantitative  flow  prediction.  If  its  empirical 
coefficients  are  fine-tuned  for  agreement  with  a  particular  physical  model,  the 
code  can  also  be  used  to  extrapolate  test  data  from  laboratory  scale  to  full 
scale.  Without  site-specific  tuning  or  adjustment  of  any  kind,  however, 
STREMR  predictions  are  still  accurate  enough  to  expedite  the  design  of  a  new 
hydraulic  structure  or  the  rehabilitation  of  an  old  one.  Earlier  versions  of  the 
model  have  proven  useful  in  studies  concerning  bendways,  diversion  tunnels, 
pump  stations,  training  structures,  and  bank  protection. 

The  STREMR  code  computes  the  mutual  interactions  between  sidewalls, 
obstacles,  and  bathymetry  to  predict  the  resulting  depth-averaged  flow  in  chan¬ 
nels  of  arbitrary  shape.  The  primary  input  consists  of  a  computational  grid 
(created  by  a  separate  grid-generation  code),  optional  velocity  distributions 
along  user-specified  inflow  and  outflow  boundaries,  and  sufficient  data  for 
depth  (or  bottom  and  surface  elevation)  to  reconstruct  the  bathymetry  by 
interpolation. 

STREMR  eliminates  a  great  deal  of  user  guesswork  by  incorporating  a  k-t 
turbulence  model  and  a  three-dimensional  (3-D)  secondary  flow  correction. 

The  turbulence  model  generates  an  eddy  viscosity  from  the  computed  primary 
flow;  and  the  secondary  flow  correction  accounts  for  the  interaction  between 
lateral  curvature  and  vertical  nonuniformity,  which  causes  high  velocities  to 
migrate  toward  the  outsides  of  channel  bends.  Manning’s  coefficient  for 
bottom  friction  is  the  only  empirical  parameter  required  in  the  code  input. 
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STREMR  uses  a  finite-volume  discretization  scheme  with  curvilinear  grids 
to  accommodate  irregular  2-D  flow  boundaries,  and  it  accounts  for  nonuniform 
bathymetry  by  assigning  a  different  depth  to  each  grid  cell.  This  stair-stepped 
discretization  of  depth  is  admissible  to  the  extent  that  depth-averaging  itself  is 
admissible.  If  the  depth-induced  forces  vary  gently  enough  with  position,  the 
resulting  3-D  effects  will  be  weak  enough  to  be  approximated  with  depth- 
averaged  corrections  for  bottom  friction  and  secondary  flow.  If  they  vary  too 
strongly  with  position,  however,  the  flow  will  have  3-D  components  large 
enough  to  invalidate  the  use  of  a  2-D  model  altogether. 

STREMR  imposes  a  rigid-lid  approximation  instead  of  a  free  surface,  but  it 
can  be  used  for  free-surface  flow  wherever  the  local  Froude  number  is  0.5  or 
less.  If  variations  in  the  width  and  depth  of  flow  are  sufficiently  gentle,  and  if 
thei^  are  no  obstacles  present  (piers,  dikes,  islands,  etc.),  then  the  code  may  be 
applicable  at  Froude  numbers  as  high  as  0.7.  In  any  case,  the  computed  pres¬ 
sure  is  equivalent  to  the  displacement  of  a  free  surface,  and  it  can  be  used  as 
an  approximation  thereof.  The  lower  the  Froude  number,  the  more  accurate 
the  approximation  becomes.  The  absence  of  a  true  free  surface  makes 
STREMR  unsuitable  for  calculations  involving  hydraulic  jumps  and  moving 
surface  waves. 


Purpose  and  Scope 

This  report  serves  as  three  documents  in  one;  an  instruction  manual  for 
STREMR  users;  a  compendi...<i  of  examples  for  code  execution  and  model 
verification;  and  a  review  of  the  governing  equations,  the  discrete  mathematics, 
and  the  computational  algorithms.  Part  11  is  an  overview  of  model  capabilities 
and  operation;  Part  III  gives  detailed  instructions  for  input  and  execution;  and 
Part  IV  explains  the  form  and  content  of  STREMR  output.  Part  V  presents 
examples  of  STREMR  input  along  with  computed  results  and  test  data,  and 
Part  VI  offers  conclusions.  Appendix  A  enumerates  the  governing  equations 
for  the  primary  flow;  Appendix  B  describes  the  turbulence  model;  and  Appen¬ 
dix  C  discusses  the  secondary  flow  correction.  Appendix  D  explains  the  trans¬ 
formation  from  Cartesian  to  curvilinear  coordinates;  Appendix  E  derives  the 
finite-volume  discretization;  and  Appendix  F  reviews  the  algorithms  used  to 
solve  the  discrete  equations. 
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2  STREMR  Overview 


Input 

User  input  for  STREMR  is  read  from  an  external  file  in  namelist  format. 
This  input  consists  mainly  of  designations  for  grid  cell  types,  initial  velocity 
distributions  for  inflow  and  outflow,  and  specifications  for  bathymetry  and 
bottom  friction.  Additional  input  parameters  allow  the  user  to  select  or  reject 
options  such  as  the  turbulence  model  and  the  secondary  flow  correction.  Grid 
coordinates  are  read  from  a  second  external  file  created  by  a  separate  grid- 
generation  code. 


Computational  Procedures 

After  reading  input  for  a  cold  start  (no  previously  computed  flow), 
STREMR  uses  the  input  velocities  to  compute  a  mass-conserving  initial  flow, 
which  it  imposes  as  a  starting  condition.  The  code  then  marches  forward  in 
time,  using  a  MacCormack  predictor-corrector  scheme  (MacCormack  1969)  for 
the  momentum  equation  and  an  Euler  upwind  scheme  (Anderson,  Tannehill, 
and  Fletcher  i984)  for  the  turbulence  and  secondary  flow  equations.  The 
MacCormack  scheme  is  a  modified  version  (Bernard  1986,  1989)  with  pressure 
computed  from  a  Poisson  equation.  The  solution  technique  for  the  Poisson 
equation  is  a  preconditioned  conjugate-gradient  method  reported  by  Kapitza 
and  Eppel  (1987),  and  the  conjugate-gradient  subroutines  in  STREMR  were 
written  by  Kapitza  (1987).  See  Appendices  A-F  for  a  complete  description  of 
the  governing  equations  and  the  computational  algorithms. 


Computational  Grids 

STREMR  uses  a  finite-volume  discretization  scheme  with  curvilinear 
boundary-fitted  grids  for  irregular  2-D  regions  (Figure  1).  The  depth-averaged 
flow  equations  are  transformed  from  Cartesian  (x,y)  coordinates,  with  arbitrary 
spacing  (Ax, Ay),  to  curvilinear  (i,f)  coordinates  with  unit  spacing  (Aj,Aj)  so  that 
At  =  Aj  -  1  between  the  grid  lines.  Every  grid  cell  is  square  in  the  computa¬ 
tional  (i,j)  plane  regardless  of  its  appearance  in  the  Cartesian  (x,y) 
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plane,  and  ail  information  concerning  cell  size  and  shape  (in  the  Cartesian 
plane)  is  absorbed  into  the  coefficients  of  the  transformation.  The  transformed 
equations  are  more  complicated  than  their  Cartesian  counterparts,  but  the 
computational  logic  is  the  same  as  that  for  a  uniformly  spaced  rectangular  grid. 
See  Appendices  D  and  E  for  details  concerning  the  transformation  and 
discretization. 

A  grid  cell  is  a  miniature  control  volume,  for  which  STREMR  calculates 
face-centered  fluxes  {U,V),  cell-centered  velocities  (u,v),  and  a  cell-centered 
pressure  p.  Figure  2  shows  the  discrete  locations  at  which  the  cell-centered 
and  face-centered  quantities  are  computed.  TTie  fluxes  f/  and  V  are  volumetric 
flux  components  normal  to  cell  faces  of  constant  i  and  constant  j,  respectively. 
Volumetric  flux  is  the  product  of  depth  at  the  cell  face,  length  of  the  cell  face, 
and  velocity  normal  to  the  cell  face. 

As  the  computed  flow  evolves  in  time,  only  U,  V,  and  p  are  carried  from 
one  time-step  to  the  next.  The  Cartesian  velocity  components  u  and  v  are 
computed  from  U  and  V  only  when  they  are  needed.  The  staggered  placement 
of  discrete  variables  (cell -centered  pressure  and  face-centered  flux)  is  called  a 
marker-and-cell  (MAC)  grid.  Curvilinear  MAC  grids  can  be  produced  by 
numerical  grid-generation  codes  such  as  WESCOR  (Thompson  1983),  which 
fits  the  grid  to  the  boundaries  of  the  flow;  or  they  can  be  fabricated  by  any 
other  boundary-conforming  procedure  that  arranges  the  grid  cells  in  rows  and 
columns  according  to  i  and  j.  Once  the  grid  has  been  generated,  attention  can 
be  focused  primarily  on  the  computational  {i,j)  plane  (Figure  3). 


Cell  Indices  and  Computational  Coordinates 

The  computational  coordinates  ({,;}  run  from  i  =  0  to  i  =  IMAX  and  from  j 
=  0  \o  j  =  JMAX  for  a  grid  that  covers  IMAX  spaces  in  the  /-direction  and 
JMAX  spaces  in  the  ;-direction.  These  integer  coordinates  {i,f)  serve  two  pur¬ 
poses  (Figure  2).  First,  they  define  the  location  of  each  node;  and  second, 
they  serve  as  indices  (labels)  for  each  cell.  Thus,  in  the  computational  plane, 
cell  {i,j)  is  the  grid  cell  whose  upper  right-hand  corner  lies  at  node  (/,/),  Since 
there  is  sometimes  no  physical  difference  between  plan  view  and  elevation 
view  for  2-D  flow,  it  is  generally  expedient  to  use  the  generic  term  "east"  for 
the  positive  /-direction,  and  "north"  for  the  positive y-direction. 

Consider  the  hypothetical  12X8  grid  shown  in  Figure  3,  for  which  IMAX 
=  12  and  JMAX  =  8.  Cells  in  the  grid  are  indicated  by  solid  lines,  and 
phantom  cells  outside  the  grid  are  indicated  by  dashed  lines.  Node  (0,0)  lies  at 
the  origin  (intersection)  of  the  /-  and  y-axes,  which  is  the  southwest  corner  of 
the  entire  grid.  This  node  is  also  the  southwest  corner  of  grid  cell  (1,1),  and 
the  northeast  corner  of  phantom  cell  (0,0).  The  northeast  comer  of  the  entire 
grid  is  node  (12,8),  which  is  also  the  northeast  corner  of  grid  cel!  (12,8),  and 
the  southwest  corner  of  phantom  cell  (13,9).  Note  that  the  phantom  cells  are 
not  part  of  the  grid  itself,  and  they  are  not  generated  with  the  grid.  Phantom 
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Figure  2.  Discrete  placement  of  cell-centered  velocities  (u,v),  face-centered 
fluxes  (U,V),  and  grid  nodes  (•)  for  cell  (i,j) 
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cells  are  merely  dummy  locations  required  by  STREMR  logic  in  the 
computational  plane. 

Grid  Cell  Types 

STREMR  classifies  cells  into  six  types:  FIELD,  NOSLIP,  SLIP,  FLUX, 

OPEN,  and  OUT.  Grid  cells  that  lie  in  the  flow  and  touch  no  boundaries  are 
FIELD  cells.  Grid  cells  that  lie  in  the  flow  and  touch  boundaries  may  be 
either  NOSLIP,  SLIP,  FLUX,  or  OPEN  cells.  OUT  cells  are  phantom  cells 
outside  the  grid,  or  inactive  (no-flow)  cells  inside  an  obstacle  (Figure  4). 

Flow  enters  or  leaves  the  grid  through  FLUX  and  OPEN  cells,  and  these 
must  have  at  least  one  entire  face  on  a  boundary.  The  volumetric  flux  through 
a  FLUX  boundary  face  is  constant,  but  the  volumetric  flux  through  an  OPEN 
boundary  face  changes  as  the  flow  evolves.  It  is  best  to  designate  inflow  cells 
as  FLUX  cells  and  outflow  cells  as  either  FLUX  or  OPEN  cells. 

SLIP  cells  touch  boundaries  that  impose  no  tangential  force  (sidewall  fric¬ 
tion)  on  the  flow,  and  NOSLIP  cells  touch  boundaries  that  do  impose  a  tan¬ 
gential  force.  SLIP  and  NOSLIP  cells  must  have  at  least  one  corner  on  a  boundary. 
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FIELD  cells  touch  no  boundaries  at  all,  and  these  are  designated  automati¬ 
cally  by  STREMR.  OUT  cells  touch  only  the  boundaries  or  each  other. 
Phantom  cells  and  no-flow  cells  inside  obstacles  (generated  with  the  grid)  are 
automatically  designated  as  OUT  cells  by  STREMR.  Note  that  solid  obstacles 
(piers,  dikes,  islands,  etc.)  are  always  filled  with  OUT  ceils  and  surrounded  by 
SUP  or  NOSLIP  cells  (Figure  4). 


CELL  TYPES 


Figure  4.  Computational  (i.j)  plane  with  12x8  grid  and  2x2  obstacle 


STREMR  makes  all  boundary-adjacent  grid  cells  NOSLIP  by  default,  and 
the  user  must  specify  other  cell  types  (SLIP,  FLUX,  or  OPEN)  wherever  they 
are  needed  along  the  boundaries.  NOSLIP  cells  can  be  converted  to  SLIP  cells 
with  a  single  input  entry  for  the  entire  grid.  Any  previously  specified  type 
except  OPEN  can  be  changed  (by  subsequent  input)  to  any  other  type  except 
FIELD.  A  cell  can  be  designated  OPEN  only  once,  as  part  of  a  single  row  or 
column  of  OPEN  cells;  its  type  cannot  be  changed  by  subsequent  input 
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Flowrate 


The  total  flowrate  is  constant  for  the  grid  as  a  whole,  and  the  fluxes  U  and 
V  through  the  boundary  faces  of  each  FLUX  cell  are  constant.  The  total  flow- 
rate  is  either  specified  by  the  user  (default)  or  computed  from  the  input 
velocities. 

For  OPEN  cells,  the  net  flow  through  a  continuous  boundary  segment  of 
OPEN  faces  is  constant,  but  the  flow  distribution  along  that  segment  may 
change  with  time.  For  this  reason,  groups  of  OPEN  cells  have  to  be  specified 
as  distinct  rows  or  columns  in  the  computational  (i,/)  plane.  STREMR  assigns 
a  particular  flowrate  to  each  user-defined  row  or  column  of  OPEN  cells,  and 
these  rows  and  columns  must  not  overlap. 


Grid  Quality 

Grids  need  not  be  orthogonal  nor  uniformly  spaced  in  the  Cartesian  {x,y) 
plane,  but  it  is  best  to  avoid  sharply  skewed  gridlines  and  abrupt  changes  in 
grid  spacing  (Figure  S).  Excessive  skewness  and  disparate  spacing  may 
degrade  accuracy  and  promote  numerical  instability.  As  a  rule  of  thumb,  the 
angles  between  intersecting  gridlines  should  be  kept  between  45  deg^  and 
135  deg;  and  the  local  change  in  grid  spacing  should  be  no  more  than  30  per¬ 
cent  from  one  cell  to  the  next.  It  is  also  wise  to  avoid  cell  aspect  ratios 
(lengthAvidth)  greater  than  10  wherever  sharp  flow  gradients  may  occur  in  the 
lengthwise  direction.  If  possible,  grid  cells  should  be  oriented  so  that  the  grid 
spacing  is  finest  in  the  direction  of  the  strongest  depth  or  velocity  gradient 

At  least  two  grid  spaces  are  needed  to  represent  an  obstacle  normal  to  the 
general  direction  of  flow  (Figure  4);  but  this  is  sufficient  only  for  the  crudest 
possible  representation.  Five  to  ten  spaces  will  produce  much  better  results, 
but  may  still  leave  grid-associated  errors  of  20  percent  or  more  in  computed 
details  such  as  the  reattachment  length  for  a  separated  flow.  Twenty  spaces 
may  reduce  these  enors  to  3  percent  or  less.  See  Part  V,  Examples  2A,  2B, 
3A,  and  3B  for  supporting  evidence. 

There  is  an  important  point  to  remember  concerning  the  magnitudes  of  the 
Cartesian  coordinates  (j;y).  In  the  process  of  discretization,  STREMR 
computes  the  difference  between  the  Cartesian  coordinates  of  neighboring  grid 
cells.  If  these  coordinates  are  very  large,  and  their  differences  very  small, 
accuracy  may  be  needlessly  lost.  To  avoid  this,  make  sure  that  the  magnitudes 
of  the  Cartesian  coordinates  (x,y)  are  commensurate  with  the  size  of  the  grid  in 
the  Cartesian  (x,y)  plane.  For  example,  if  the  grid  covers  only  100  metres  in 
the  x-direction  and  300  metres  in  the  y-dircction,  then  neither  x  nor  y  should 


*  A  table  of  factors  for  converting  non-SI  units  of  measurement  to  SI  (metric)  units  is 
presented  on  page  ix). 
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exceed  1000  metres.  If  the  original  value  for  the  maximum  x-coordinate  is 
1,000,000  metres  in  this  case,  die  (x,y)  origin  needs  to  be  moved  so  that  the 
maximum  x-coordinate  becomes  1000  metres  or  less.  Otherwise,  four  signifi¬ 
cant  figures  will  be  lost  in  each  differencing  operation. 


Nonuniform  Bathymetry 

STREMR  employs  d^th-averaged  approximations  for  bottom  friction  and 
3-D  secondary  flow,  but  these  are  valid  only  for  gentle  variations  in  depth 
(Figure  6).  This  means  that  the  bottom  slope  should  be  less  than  45  deg  (mea¬ 
sured  from  the  horizontal)  when  it  involves  a  change  in  depth  of  50  percent  or 
more  over  the  entire  slope.  Submerged  features  may  cause  numerical  insta¬ 
bility  if  they  impose  dramatic  depth  changes  with  bottom  slopes  greater  than 
45  deg;  but  even  when  they  do  run  successfully,  the  computed  results  should 
be  viewed  with  considerable  skepticism.  Side  slopes  greater  than  45  deg 
should  be  replaced  with  vertical  sidewalls. 
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Figure  6.  Elevation  view  of  gentle  (a)  and  abrupt  (b)  variations  in  depth 


STREMR  accommodates  nonuniform  bathymetry  by  allowing  a  different 
dq)th  in  every  grid  cell,  which  produces  a  stair-stepped  depth  discretization  in 
the  computational  space  (Figure  7).  Note,  however,  that  the  same  depth  is 
assigned  to  every  grid  cell  by  default,  and  this  has  to  be  changed  for  individual 
cells  and  groups  of  cells  by  user  input. 

STREMR  accepts  input  for  either  the  flow  depth  or  the  bottom  and  surface 
elevations,  but  not  for  depth  and  elevations  together.  If  elevations  are  speci¬ 
fied,  STREMR  obtains  the  depth  by  subtracting  the  elevation  of  the  bottom 
from  the  elevation  of  the  surface.  Depth  (or  elevation)  input  is  accepted  for 
sections,  line  segments,  individual  cells  (or  points),  and  also  for  the  grid  as  a 
whole.  Input  for  sections  must  be  specified  with  computational  (y)  coordi¬ 
nates,  but  input  for  line  segments  and  points  can  be  specified  with  either  (i,y) 
or  (jt,y)  coordinates. 
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Figure  7.  Discrete  representation  of  flow  depth  (negative  z-direction)  for  a  row  of  grid  cells  in 
the  computational  (i,j)  plane 


Bottom  Friction 

STREMR  accounts  for  bottom  resistance  with  Manning’s  equation,  which 
gives  the  (nondimensional)  bottom  friction  factor  (Appendix  A)  as  a  function 
of  the  depth  and  the  Manning  coefficient  n.  Values  for  n  are  specified  in  the 
same  manner  as  the  depth,  with  input  accepted  for  sections,  line  segments, 
individual  cells  (or  points),  and  also  for  the  grid  as  a  whole.  Note  that  the 
default  condition  in  STREMR  is  no  bottom  friction  (n  -  O'),  and  it  is  up  to  the 
user  to  input  nonzero  values. 


Automatic  Interpolation  of  Input 

STREMR  offers  an  optional  interpolation  scheme  that  fills  in  the  values  of 
Manning’s  coefficient  and  depth  (or  elevation)  at  all  locations  not  ^ecified  in 
the  user  input.  In  this  scheme,  STREMR  treats  the  values  at  the  specified 
locations  as  though  they  were  fixed  boundary  conditions,  and  then  solves  a 
Laplace  equation  for  the  values  at  the  remaining  (unspecified)  locations.  This 
allows  the  creation  of  a  smooth  distribution  from  sparse  user  input.  The  inter¬ 
polation  is  activated  by  default,  but  it  can  be  rejected  by  user  input. 
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Eddy  Viscosity 


STREMR  accounts  for  turbulence  by  including  an  eddy  viscosity  in  the 
depth-averaged  governing  equations  for  the  primary  and  secondary  flow.  This 
is  obtained  from  a  k-t  turbulence  model  (Launder  and  Spalding  1974),  which 
consists  of  en:pirical  transport  equations  for  the  turbulence  energy  k  and  the 
turbulence  dissipation  rate  e.  STREMR  solves  these  equations  and  computes 
the  local  eddy  viscosity  v  from  the  results. 

Included  with  the  k-t  model  is  an  empirical  procedure  for  calculating  turbu¬ 
lence  energy,  dissipation  rate,  and  shear  stress  near  sidewalls  and  obstacles. 
This  procedure  is  not  suitable  for  modeling  turbulent  boundary  layers,  but  it 
does  a  fair  job  of  predicting  flow  separation  on  curved  sidewalls.  See  Part  IV, 
Example  4,  for  supporting  evidence. 

The  turbulence  model  is  activated  in  STREMR  by  default;  but  it  is  optional, 
and  users  can  reject  it  via  the  input.  If  the  turbu<ence  model  is  rejected,  then 
STREMR  uses  a  kinematic  viscosity  specified  by  the  user.  In  the  latter  case, 
the  code  accepts  only  one  viscosity  for  the  entire  flow,  and  the  sidewall  shear 
stress  is  then  calculated  from  a  viscous  no-slip  condition  (Appendix  B).  Ordi¬ 
narily  one  should  keep  the  turbulence  model  activated  in  STREMR  calcula¬ 
tions,  because  it  offers  a  better  approximation  for  the  eddy  viscosity  than  can 
be  obtained  by  guesswork  alone.  Only  for  laminar  flow  calculations  (at  low 
Reynolds  number)  should  the  turbulence  model  be  omitted. 


Secondary  Flow  Correction 

Curved  channels  often  develop  a  3-D  secondary  flow  (spiral  motion)  that 
causes  the  highest  velocities  to  migrate  toward  the  outsides  of  the  bends. 
STREMR  accounts  for  this  by  solving  an  empirical  transport  equation  for 
streamwise  vorticity  (Appendix  C),  which  creates  a  secondary  shear  stress  in 
the  depth-averaged  momentum  equation  (Appendix  A).  The  secondary  flow 
correction  is  activated  by  default,  but  no  secondary  flow  is  produced  unless 
Manning’s  coefficient  is  greater  than  zero.  Users  can  reject  it  altogether  via 
the  input  (regardless  of  the  value  of  Manning’s  coefficient). 


Dimensional  Units 

Internally  STREMR  uses  only  SI  units  of  length  (meters),  but  input  may  be 
specified  in  SI  units  (meters,  square  meters,  cubic  meters,  and  seconds)  or 
English  units  (feet,  square  feet,  cubic  feet,  and  seconds).  Printed  output  is 
available  in  SI  or  English  units,  with  time  expressed  in  seconds.  A  table  for 
converting  English  units  to  SI  units  is  given  on  page  ix. 
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Variable  Time-Step 


Users  may  either  specify  a  fixed  time-step  or  let  STREMR  set  its  own 
variable  time-step  automatically  from  numerical  stability  considerations.  The 
variable  time-step  eliminates  much  guesswork  from  the  input,  and  it  allows  the 
code  to  approach  a  steady  state  as  quickly  as  possible.  Users  may  specify  the 
interval  at  which  the  time-step  is  to  be  reset. 


Output 

STREMR  stores  information  for  printing,  plotting,  and  future  hot  starts 
(restarts  from  a  previously  computed  flow)  in  separate  output  files.  Condensed 
flow  information  is  available  at  user-specified  print  intervals,  and  a  cell-by-cell 
printout  is  available  at  user-specified  storage  intervals.  Output  to  be  used  for 
future  hot  starts  is  overwritten  after  each  storage  interval.  At  the  beginning  of 
a  hot  start,  STREMR  reads  a  previously  computed  hot-start  file  before  reading 
the  namelist  input.  Printed  maps  of  the  relative  values  of  selected  variables  are 
available  at  the  end  of  each  STREMR  run. 
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3  STREMR  Input  and 
Execution 


Array  Dimensions 

The  2-D  arrays  in  STREMR  have  dimensions  IDIM  and  JDIM  in  the  i-  and 
y-directions,  respectively.  These  dimensions  are  specified  by  parameter  state¬ 
ments  in  each  of  the  five  subroutines  of  the  source  code;  c.g., 

PARAMETER  (  IDIM  =  52  ,  JDIM  =  19  ) 


Inside  the  grid,  the  cell  indices  run  from  i  -  1  to  i  =  IMAX  and  from  ;  =  /  to 
j  =  JMAX-,  but  STREMR  also  uses  a  perimeter  of  phantom  OUT  cells  around 
the  outside  of  the  grid  (Figure  4).  The  indices  for  the  STREMR  arrays  must 
then  run  from  i  =  0  to  i  =  IMAX  +  1  and  from  y  =  <7  to  y  =  JMAX  +  /  at  the 
very  least 

In  general,  IDIM  must  equal  or  exceed  IMAX  +  I  and  JDIM  must  equal  or 
exceed  JMAX  +  1 ;  but  the  code  runs  faster  with  IDIM  =  IMAX  +  1  and  JDIM 
=  JMAX  +  1.  For  grids  with  500  cells  or  more,  it  is  usually  worthwhile  to 
recompile  STREMR  to  these  dimensions  with  each  change  of  IMAX  and 
JMAX  (i.e.,  with  each  change  of  grid  dimensions).  In  any  case,  the  source 
code  has  to  be  recompiled  whenever  IDIM  and  JDIM  arc  changed  for  any 
reason. 

Before  changing  IDIM,  note  that  IDIM  must  have  the  same  value  in  each 
of  the  five  STREMR  subroutines.  That  also  goes  for  JDIM;  but  note  that 
IDIM  and  JDIM  need  not  be  equal  to  each  other. 


Namelists  and  Variable  Types 

The  namelist  input  format  is  an  extension  of  FORTRAN  77  that  is  sup¬ 
ported  by  many  FORTRAN  compilers.  It  is  especially  convenient  for  codes 
that  accept  numerous  input  parameters,  as  STREMR  does.  Namelist  format 
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differs  from  standard  input  format  in  that  it  recognizes  input  quantities  by  their 
FORTRAN  names  instead  of  by  their  locations  in  an  input  file. 


STREMR  employs  namelist  format  for  all  user-specified  input.  Variables 
may  be  specified  in  any  order  within  a  given  namelist,  but  the  namelists  them¬ 
selves  must  appear  in  a  specific  order.  Individual  variables  can  be  omitted 
from  a  given  namelist,  in  which  case  the  code  will  assign  default  values  (for  a 
cold  start)  or  previously  stored  values  (for  a  hot  start)  to  the  omitted  variables. 
Certain  required  namelists  must  never  be  omitted  from  the  input.  Missing 
namelists  and  namelists  out  of  order  will  cause  STREMR  to  stop  or  abort. 

A  cold  start  requires  three  different  namelists  (in  order)  called  BEGIN, 
PARAM,  and  INPUT.  A  hot  start  requires  BEGIN  and  PARAM,  but  not 
INPUT.  In  either  case,  BEGIN  and  PARAM  appear  only  once  each;  but 
INPUT  appears  repeatedly  (at  least  ten  times)  in  the  input  for  a  cold  start 
Each  of  these  namelists  accepts  three  types  of  variables:  CHARACTER, 
INTEGER,  and  REAL  (floating-point). 


Namelist  BEGIN 

The  first  input  namelist  for  hot  starts  and  cold  starts  is  BEGIN,  which 
accepts  the  input  variables  explained  in  Tables  1-3.  When  specifying  input 
values,  it  is  helpful  to  organize  the  variables  in  columns  according  to  their 
type.  Consider  the  following  hypothetical  example: 

&BEGIN  START=’COLD’  ,  IREF=1,  TURBIN=0,003, 

FLOW=’FLOWRATE’  ,  JREF=5,  PECLET=50.  , 

IUNITS= ’METRIC’ 

TITLE= ’HYPOTHETICAL  INPUT’  &END 

Note  that  an  ampersand  &  in  column  2  must  always  precede  the  first  letter 
of  the  namelist  name  in  column  3.  This  signals  the  beginning  of  the  input  for 
a  given  namelist,  and  the  delimiter  &END  signals  the  end.  A  comma  must 
follow  each  value  assigned,  except  for  the  last  entry  in  the  namelist,  which  is 
followed  by  &END. 

START  activates  cold  starts  and  hot  starts.  The  only  variable  that  must  be 
specified  for  hot  starts  is  START  =  'HOT,  but  STREMR  also  reads  and  uses 
new  values  (if  any)  specified  for  IREF,  JREF,  and  TITLE.  It  is  usually  better 
not  to  change  IREF  and  JREF  from  their  cold-start  values,  but  TITLE  may 
change  with  each  new  hot  start.  The  other  variables  in  namelist  BEGIN  have 
no  influence  on  hot  starts. 

If  VGUESS  =  'YES’,  STREMR  uses  all  velocities  input  by  the  user  to 
calculate  an  initial  flow  field.  These  velocities  arc  adjusted  automatically  to 
achieve  conservation  of  mass,  but  the  resulting  vorticity  is  the  same  as  that 
imposed  by  the  input  velocities.  Otherwise,  when  VGUESS  =  'NO\ 
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Table  1 

CHARACTER  Variables  Used  in  Namelist  BEGiN 

Variable 

Value 

Explanation 

START  = 

■COLD' 

Cold  start  (default). 

START  = 

■HOT 

Hot  start 

VGUESS  = 

■YES’ 

All  user-specified  velocities  will  be  used  for  the  initial  flow. 

VGUESS  - 

■NO' 

Only  user-specified  velocities  in  FLUX  and  OPEN  cells  will 
be  used  for  the  initial  flow  (default). 

FLOW  = 

■FLOWRATE' 

Rowrate  will  be  specified  by  user  (default). 

FLOW  = 

■INFLOW 

Rowrate  will  be  computed  from  user-specified  inflow 
velocities. 

FLOW  = 

■OUTFLOW 

Rowrate  will  be  computed  from  user-specified  outflow 
velocities. 

lUNITS  = 

■METRIC 

Input  unKs  will  be  SI  (metric)  units:  rrvsters,  square  meters, 
cubic  rrMters,  and  seconds  (default). 

lUNiTS  = 

•ENGLISH' 

Input  units  will  be  non-SI  (English)  units:  feet,  square  feet, 
cubic  feet,  and  seconds. 

ELEVAT  = 

■YES' 

Depth  values  will  be  computed  from  surface  and  bottom 
elevations  specified  by  user. 

ELEVAT  = 

■NO' 

Depth  values  will  be  input  directly  by  user  (default). 

INTERP  = 

■YES' 

Unspecified  values  for  depth,  etc.,  will  be 
computed  by  interpolation  (default). 

INTERP  = 

NO' 

Unspecified  values  for  depth,  etc.,  will  be 

assigned  the  default  value  or  the  user-specified  general 

value  for  that  quantity. 

TITLE  = 

User-specified  title  for  plots  and  printed  output.  Maximum 
length  is  80  ^aracters  and  spaces. 

Table  2 

INTEGER  Variables  Used  in  Namelist  BEGiN 

Variable 

Explanation 

IREF 

l-index  of  reference  cell  which  will  be  assigned 
a  zero  value  of  pressure.  Detauit  value  is  that 
for  the  first  FLUX  or  OPEN  cell  to  be  found  in  a 
left-to-right,  bottom-to-top  search  of  the 
computational  (i,j)  plane. 

JREF 

J-index  of  reference  cell.  Default  value  is 
assigned  In  same  manner  as  that  for  IREF. 
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Table  3 

REAL  Variables  Used  in  Namelist  BEGIN 

Variable 

Explanation 

TURBIN 

Inflow  value  for  ratio  of  turtxjlence  energy  to 
velocity  squared.  (Default  s  0.003) 

PECLET 

Initlat  Pedet  number  in  refaranoe  cell. 

Used  only  wWi  turbulence  model. 

(Default  SO.) 

REDUCE 

Scale-reduction  factor  by  which  aH  input  for 
depth,  elevation,  velocity,  and  grid  spacing 
will  be  divided.  (Default  =1.) 

STREMR  uses  only  the  normal  components  of  the  input  velocities  along 
FLUX  and  OPEN  boundaries.  In  this  case,  the  resulting  initial  flow  inside  the 
grid  is  irrotational  (no  vorticity).  The  default  (VGUESS  =  ’NO’)  should 
ordinarily  be  used,  but  the  alternative  {VGUESS  =  ’YES’)  is  sometimes  needed 
so  that  small  initial  velocities  can  be  specified  in  troublesome  areas  to 
avoid  numerical  instability. 

When  FLOW  =  ’FLOWRATE’  (default),  STREMR  adjusts  the  inflow  and 
outflow  velocities  so  that  they  match  a  user-specified  flow  rate  before  com¬ 
puting  the  internal  initial  flow.  When  FLOW  =  ’INFLOW’,  the  outflow 
velocities  are  adjusted  to  match  the  flow  rate  produced  by  the  user-specified 
inflow  velocities.  The  opposite  is  true  when  FLOW  =  ’OUTFLOW’. 
Regardless  of  the  option  chosen,  however,  the  adjusted  velocities  have  the 
same  relative  distributions  (along  FLUX  and  OPEN  boundaries)  as  the  input 
velocities. 

lUNITS  determines  the  units  for  all  input  flow  variables  except  Manning’s 
coefficient  (for  which  no  units  have  to  be  specified).  This  eliminates  the  need 
to  specify  units  for  any  input  variable  unless  they  are  different  from  lUNITS. 
ELEVAT  determines  whether  the  code  will  accept  input  for  depth  or  for  bot¬ 
tom  and  surface  elevations.  STREMR  accepts  depth  or  elevation,  but  not 
both.  INTER?  controls  the  automatic  interpolation  of  input  for  depth  (or  ele¬ 
vation)  and  Manning’s  coefficient. 

The  reference  cell  (IREF,JREF)  is  used  for  setting  reference  values  for 
pressure,  turbulence  energy,  and  turbulence  dissipation  rate.  In  principle  it  can 
be  any  cell  except  an  OUT  cell.  Nevertheless,  since  the  rigid-lid  pressure  is 
the  same  as  free-surface  displacement  at  low  Froude  number,  it  is  best  to  place 
the  reference  cell  next  to  the  midpoint  of  an  inflow  boundary.  This  is  the 
equivalent  to  setting  a  reference  elevation  for  the  water  surface  at  a  single 
upstream  location.  The  computed  pressure  then  gives  the  decline  in  water- 
surface  elevation  necessary  to  maintain  the  input  flowrate,  regardless  of  any 
other  user-specified  depths  or  elevations. 
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The  scale-reduction  factor  REDUCE  is  a  convenient  parameter  for  changing 
the  model  scale  without  changing  the  input  for  the  grid  or  the  bathymetry.  It 
is  especially  useful  when  comparing  STREMR  predictions  (for  a  given 
geometry)  with  small-scale  data  from  physical  models  and  with  full-scale  data 
from  field  tests.  All  x-  and  y-coordinates  for  the  grid  and  all  input  values  for 
velocity  and  depth  (or  elevation)  are  divided  by  REDUCE.  Thus,  REDUCE 
must  be  less  than  unity  to  increase  the  scale  and  greater  than  unity  to  decrease 
the  scale.  Note  that  if  FLOW  =  ’FLOWRATE’,  however,  the  user-^ecified 
flow  rate  is  not  changed  by  REDUCE. 

The  variables  TURBIN  and  PECLET  are  used  by  STREMR  only  when  the 
turbulence  model  is  activated  (default).  TURBIN  is  the  ratio  of  turbulence 
energy  to  initial  velocity  squared  in  the  reference  cell  (IREF,JREF),  and  this 
reference  energy  is  the  inflow  turbulence  energy  for  all  FLUX  cells.  PECLET 
is  the  initial  Peclet  number  (cell  Reynolds  number)  in  the  reference  cell,  based 
on  the  local  grid  spacing  and  the  initial  velocity  (Appendix  B).  This 
determines  the  inflow  dissipation  rate  for  all  FLUX  cells.  The  default  values 
(TURBIN  =  0.003  and  PECLET  =  50.)  should  ordinarily  suffice  for  most 
STREMR  applications,  but  they  can  be  changed  at  the  user’s  discretion. 


Namelist  PARAM 


The  second  input  namelist  for  hot  starts  and  cold  starts  is  PARAM,  which 
accepts  the  input  variables  explained  in  Tables  4-6.  These  variables  may  be 
assigned  one  set  of  values  for  a  cold  start  and  a  different  set  of  values  for 
subsequent  hot  starts.  As  with  BEGIN,  it  is  helpful  to  arrange  the  input  for 
PARAM  in  columns  according  to  type.  Consider  the  following  hypothetical 
example: 


&PARAM  PUNITS= ’METRIC’, 
ALLOUT=’YES’ 
MAPS=’YES’ 
TIMER=’NO’ 


NSTEPS=300, 

NSTORE=200, 

NSTOMO=lOO, 


DT1ME=0.1, 
RECAP=2.5, 
DRAG=1.0, 
AVIS=1.0, 


INFORM=10 
ITERS=3  &END 


The  CHARACTER  variables  in  PARAM  serve  as  on/off  switches  for 
options  that  can  be  activated  or  deactivated  for  cold  starts  and  subsequent  hot 
starts.  For  example,  one  might  run  a  cold  start  with  a  variable  time-step 
(TIMER  =  ’YES’)  and  a  hot  start  with  a  fixed  time-step  (TIMER  =  ’NO’) 
whose  value  is  given  by  DTIME  in  the  input. 

PUNITS  determines  the  units  in  which  all  output  will  be  printed,  regardless 
of  the  input  units  set  by  lUNITS  (in  namelist  BEGIN).  This  does  not  affect 
the  units  for  stored  output,  however,  which  are  always  metric  (SI)  units. 

NSTEPS  is  the  total  number  of  time-steps  executed  in  a  given  run.  If 
NSTEPS  =  0  (cold  starts  only),  STREMR  will  compute  and  store  the  initial 
flow  without  marching  forward  in  time.  This  option  is  convenient  when  trying 
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Table  4 

CHARACTER  Variables  Used  in  Namelist  PARAM 

Variabi* 

Value 

Explanation 

PUNITS  = 

‘METRIC’ 

Printed  information  will  be  in  SI  (metric)  units:  meters,  square 
meters,  cubic  meters,  and  seconds  (default). 

PUNITS* 

•ENGLISH' 

Printed  information  will  be  in  English  units;  feeL  square  feet 
cubic  feet  and  seconds. 

ALLOUT  = 

•YES' 

Complete  listing  of  flow  variables  will  be  printed  each  time  out¬ 
put  is  stored  for  plotting  and  hot  starts  (default). 

ALLOUT  = 

'NO' 

Complete  listing  of  flow  variables  will  not  be  printed,  but  partial 
listing  may  be  printed,  depending  on  input  values  for  the  print 
indices  (IPMIN,  IPMAX,  JPMIN,  JPMAX,  ISKIP,  and 

JSKIP). 

MAPS  ^ 

•YES' 

Maps  of  cell  types  and  flow  variables  will  be  printed  at  end  of 
STREMR  run  (default). 

MAPS  = 

•NO' 

Maps  will  not  be  printed. 

TIMER  = 

■YES’ 

Variable  time-step  will  be  activated  (default). 

TIMER  = 

•NO' 

Variable  time-step  will  not  be  activated. 

KETURB  = 

■YES' 

Turbulence  model  will  be  activated  (default). 

KETURB  = 

•NO' 

Turbulence  model  will  not  be  activated. 

BENDER  > 

•YES' 

Secondary  flow  will  be  activated  (default). 

BENDER  = 

•NO' 

Secondary  flow  will  not  be  activated. 

Table  5 

INTEGER  Variables  Used  in  Namelist  PARAM 

Variable 

Explanation 

NSTEPS 

Total  number  of  time-steps  to  be  executed  in  a  given  run. 

(Default  =  1) 

NSTORE 

Rrst  time-step  for  which  output  is  to  be  stored. 

((default  =  f) 

NSTOMO 

Subsequent  inlerval  beyond  NSTORE  (in  time-steps)  at  which 
output  is  to  be  stored.  (Default  =1) 

INFORM 

Interval  On  time-steps)  at  which  variable  time-step 
will  be  reset,  and  at  which  condensed  flow  inlormation 
wHI  be  printed.  (Default  =  f  0) 

ITERS 

Number  of  iterations  used  in  solution  of  Poisson  equation 
for  pressure.  (Default  >  3) 

IMAP 

Maximum  width  of  printed  maps  in  the  computational  O.D  pinne  (measured  in  grid 
spaces).  Maps  with  width  greater  than  IMAP  will  be  broken  into  horizontal  sections 
and  stacked  with  the  leftmost  section  on  top.  (Default  =<  130) 

(Continued) 
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Tabl«  5  (Concluded) 

Variabki 

ExfManation 

IPMIN 

Smallest  I -index  for  partial  ceil-by-ceH  listing 
of  flow  variables.  (Default  =  0) 

IPMAX 

Largest  l-index  for  partial  listing.  (Default  =  0) 

JPMIN 

Smallest  J-index  for  partial  listing.  (Default  =  0) 

JPMAX 

Largest  J-index  for  partial  listing.  (Default  =  0) 

ISKIP 

Skip  interval  for  l-irKlex  in  partial  listing.  (Default  =  1) 

JSKIP 

Skip  interval  for  J-index  in  partial  listing.  (Default  1) 

Table  6 

REAL  Variables  used  in  Namelist  PARAM 

Variable 

Explanation 

DT1ME 

Time-step  in  seconds  if  TIMER  =  'NO'.  (Default  »  1 .0) 

SAFE 

Safety  factor  for  automatic  calculation  of  variable  time-step  if  TIMER  s  'YES' . 

(Default  >  0.9) 

DRAG 

Coefficient  for  increasing  or  decreasing  sidewall  shear  stress.  Used  only  with 
turbulence  model.  (Default  s  1 .0) 

AVIS 

Coefficient  for  increasing  or  deaeasing  all  viscosity,  whether  input  by  user  or 
computed  by  turbulence  model.  (Default  =  1 .0) 

RECAP 

Turbulence  adjustment  parameter  Rq  for  eddy  viscosity. 

(Default  •  2.5)  Set  RECAP  =1.0  for  standard  k-c  model. 

ASEC 

Production  coefficient  A^  for  secondary  flow.  Do  not  change  default  value  wHhout 
reading  Appendix  C!  (Default  =  5.0) 

DSEC 

Decay  coefficient  D^  for  secondary  flow.  Do  rxrt  change  default  value  without 
reading  Appendix  C!  (Default  =  0.5) 

new  grids  or  new  sets  of  input,  because  it  allows  users  to  find  and  correct 
many  kinds  of  input  errors  without  wasting  much  computer  time  on  erroneous 
calculations.  If  no  input  errors  are  found,  the  stored  initial  flow  can  be  used  as 
input  for  a  hot  start  Note  that  for  hot  starts,  however,  NSTEPS  must  be 
greater  than  zero. 

NSTORE  is  the  first  interval  (number  of  time-steps)  after  which  data  will 
be  stored  for  plots  and  future  hot  starts,  and  NSTOMO  is  the  subsequent 
interval  for  storage.  Thus,  the  first  set  of  data  will  be  stored  when  NSTORE 
time-steps  have  been  computed;  and  the  second  set  will  be  stored  when 
NSTORE  +  NSTOMO  time-steps  have  been  computed  since  the  beginning  of 
the  run.  Storage  is  repeated  at  intervals  of  NSTOMO  time-steps  until  the  total 
number  reaches  NSTEPS  for  that  run. 


Chapter  3  STREMR  Input  and  Exacudon 


21 


ALLOUT  determines  whether  a  cell-by-cell  listing  of  flow  variables  will  be 
printed  at  the  end  of  each  storage  interval.  If  ALLOUT  =  ’YES'  (default), 
STREMR  prints  a  complete  listing  of  flow  variables.  Otherwise,  if  ALLOUT 
=  ’NO’,  STREMR  prints  a  partial  listing  unless  IPMIN  =  0.  Thus,  one  may 
obtain  a  full  listing,  a  partial  listing,  or  no  listing  at  all.  MAPS  determines 
whether  maps  of  cell  types  and  relative  values  of  flow  variables  (1  to  9)  will 
be  printed  at  the  end  of  the  run.  These  maps  are  also  printed  when  a  calcula¬ 
tion  becomes  unstable  (regardless  of  the  input  value  for  MAPS)  if  STREMR 
can  detect  the  instability  before  blowing  up. 

KETURB  and  BENDER,  respectively,  control  the  turbulence  model  and  the 
secondary  flow  correction.  When  KETURB  =  ’YES’  (default),  the  computed 
flow  is  turbulent,  with  eddy  viscosity  generated  automatically  by  the  turbu¬ 
lence  model.  When  KETURB  =  ’NO’,  the  computed  flow  is  laminar,  with 
constant  viscosity  (user-specified).  Likewise,  when  BENDER  =  ’YES’ 
(default),  the  influence  of  secondary  flow  is  included  with  bottom  friction. 
Otherwise,  when  BENDER  =  ’NO’,  the  secondary  flow  is  omitted  altogether. 

With  the  variable  time-step  activated  (default),  the  time-step  is  computed 
automatically  by  STREMR,  and  no  input  value  is  needed  for  DTIME.  At 
designated  intervals  (INFORM),  and  at  the  end  of  each  storage  interval, 
STREMR  resets  the  variable  time-step  and  prints  condensed  information  about 
the  current  state  of  the  computed  flow. 

The  condensed  information  includes  a  quantity  called  EMAX,  which  is  an 
index  for  convergence  of  the  iterative  pressure  calculation.  As  a  rule  of 
thumb,  EMAX  should  be  less  than  0.02,  but  larger  values  may  be  acceptable 
for  transient  flow  conditions.  Anomalies  are  often  quite  noticeable  in  the 
computed  flow  when  EMAX  approaches  or  exceeds  0.1.  Increasing  ITERS 
(the  number  of  pressure  iterations)  usually  reduces  EMAX,  and  vice  versa. 

Whenever  the  variable  time-step  is  activated  (TIMER  =  ’YES'  acfault 
values  should  ordinarily  be  used  for  the  REAL  variables  in  namelist  PARAM. 
Note  that  SAFE  is  the  fraction  of  the  maximum  allowable  time-step  that 
STREMR  will  use  in  setting  the  variable  time-step.  If  stability  problems  arise, 
they  can  sometimes  be  overcome  by  making  SAFE  less  than  its  default  value 
(0.9).  If  the  variable  time-step  is  not  activated  (TIMER  =  ’NO’),  a  fixed  value 
must  be  specified  for  the  time-step  DTIME  in  seconds.  In  the  latter  case, 
stability  problems  can  sometimes  be  overcome  by  reducing  DTIME. 

Whenever  the  turbulence  model  is  activated  (KETURB  =  ’YES’),  sidewall 
resistance  can  be  increased  (or  decreased)  by  making  DRAG  greater  (or  less) 
than  unity.  The  eddy  viscosity  can  be  reduced  (or  increased)  in  regions  of  low 
velocity  and  strong  turbulence  by  increasing  (or  reducing)  RECAP,  which  is 
the  STREMR  name  for  the  turbulence  adjustment  parameter  in 
Appendix  B. 

The  default  value  RECAP  =  2.5  is  used  for  the  modified  k-t  model  in 
STREMR,  and  it  is  set  slightly  high  to  compensate  for  anticipated  grid  error 
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on  coarse  grids.  Note  that  the  standard  k-t  model  can  be  imposed  by  setting 
RECAP  =  1.0.  With  or  without  the  turbulence  model  activated,  however,  the 
viscosity  can  be  uniformly  increased  (or  decreased)  everywhere  by  making 
AVIS  greater  (or  less)  than  unity.  As  for  the  secondary-flow  coefficients 
and  in  Appendix  Q  only  the  default  values  (ASEC  =  5.0  and  DSEC  =  0.5) 
should  be  used  for  the  conesponding  STREMR  parameters. 


Namelist  INPUT 


For  cold  starts  only,  the  third  namelist  is  INPUT.  This  namelist  is  used 
repeatedly  for  the  input  of  cell  types  and  for  the  input  of  general  (global) 
values,  section  values,  line  values,  and  random  (single-cell)  values  of  the  initial 
flow  variables.  Even  if  no  cell  types  or  flow  variables  are  specified  for  a  cold 
start,  INPUT  must  appear  at  least  ten  times: 

&INPUT  ITEM=’CELL  TYPES’  &END 

&INPUT  ITEM=’END’  &END 

&INPUT  ITEM=’GENERAL’  &END 
&INPUT  ITEM=’END’  &END 
&INPUT  ITEM=’SECTION’  &END 
&INPUT  ITEM=’END’  &END 

&INPUT  ITEM=’UNE’  &END 
&INPUT  ITEM=’END’  &END 
&INPUT  ITEM=’RANDOM’  &END 
&INPUT  ITEM=’END’  &END 

If  any  one  of  these  ten  INPUT  namelists  is  missing  or  out  of  order,  STREMR 
will  stop  or  abort. 

The  ten  required  occurrences  of  INPUT  come  in  five  pairs,  which  open  and 
close  five  different  categories  of  input  In  each  pair,  the  character  variable 
ITEM  opens  the  input  category  (e.g.,  ITEM  =  ’CELL  TYPES’),  and  it  also 
closes  the  input  category  (ITEM  =  ’END’).  Additional  INPUT  namelists  can 
be  inserted  between  the  opening/closing  pair  for  each  category,  with  ITEM 
used  to  indicate  the  input  quantities  to  be  specified  in  each  case. 


Input  for  Cell  Types 

In  the  first  input  category,  the  namelist  INPUT  is  used  to  specify  cell  types. 
The  integer  pairs  (II  Jl)  and  (I2J2)  indicate  rows  (J1  =  J2),  columns  (II  - 
12),  and  rectangular  sections  (II  *  12  and  JI  *•  J2)  in  the  computational  (i,/) 
plane.  TThe  INPUT  namelist  instructions  for  cell  types  are  given  in  Table  7. 

Each  row  or  column  of  OPEN  cells  has  a  separate  identity  and  must  not 
overlap  any  other  row  or  column  of  OPEN  cells.  Note  also  that  OPEN  cells 
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Table  7 

Instructions  for  INPUT  Namelist  Sequence  to  Specify  Cell  Types 

1.  The  opening  INPUT  namelist  for  cell  types  contains  only  the  CHARACTER  variable 

ITEM  =  'CELL  TYPES’ 

2.  Intermediate  INPUT  namelists  (if  any)  must  contain  ITEM  and  the  INTEGER  indices  11 ,  12.  J1 , 
and  J2.  ITEM  indicates  the  cell  type  to  be  specified.  The  indices  dictate  cell  locations  in  the  (i.j) 
plane. 

Variable 

Value 

Explanation 

ITEM  = 

'FLUX' 

FLUX  cells  (fixed  inflow  or  outflow) 

ITEM  = 

'OPEN' 

OPEN  cells  (variable  inflow  or  outflow) 

ITEM  = 

■SLIP' 

SLIP  cells  (no  sidewall  friction) 

ITEM  = 

■NOSUP' 

NOSLIP  cells  (default  along  boundaries) 

ITEM  = 

•OUT 

OUT  cells  (phantom  cells  outside  grid  and  inactive  cells  inside 
obstacles) 

ITEM  = 

'ALL  SLIP' 

Converts  all  existing  NOSLIP  cells  to  SLIP  cells 

11  = 

Smallest  INTEGER  i-index  for  row,  column,  or  section  (1  to  IMAX) 

J1  = 

Smallest  INTEGER  j-index  for  row,  column,  or  section  (1  to  JMAX) 

12  = 

Largest  INTEGER  i-index  for  row,  column,  or  section  (1  to  IMAX) 

J2  » 

Largest  INTEGER  j-index  for  row,  column,  or  section  (1  to  JMAX) 

3.  Item  2  must  be  repeated  for  each  separate  row,  column,  or  section  of  cell  types  to  be 
specified. 

4.  The  closing  INPUT  namelist  for  cell  types  contains  only  the  CHARACTER  variable 

ITEM  =  ’END’ 

cannot  be  changed  by  subsequent  input.  STREMR  will  slop  if  the  cell  type  is 
specified  more  than  once  for  an  OPEN  cell  at  a  single  location  in  the  computa¬ 
tional  (/,/)  plane.  Sec  Appendix  E  for  an  explanation  of  the  radiation  boundary 
condition  for  OPEN  cells. 

Input  for  SLIP,  NOSLIP,  and  OUT  cells  can  be  specified  in  rectangular 
sections,  as  long  as  the  final  configuration  leaves  only  rows  and  columns  of 
SLIP  and  NOSLIP  cells.  In  this  case,  the  indices  (11, JJ)  indicate  the  lower  left 
cell  and  {12, J2)  the  upper  right  cell  of  the  section.  Input  for  FLUX,  SLIP, 
NOSLIP,  and  OUT  cells  can  overlap.  When  the  cell  type  is  specified  more 
than  once  for  a  FLUX,  SLIP,  NOSLIP,  or  OUT  cell  with  indices  {i,j),  the  last 
designation  replaces  all  previous  designations.  Remember  that  NOSLIP  is  the 
default  cell  type  along  all  grid  boundaries.  Any  cell  that  does  not  lie  next  to  a 
boundary  (i.e.,  docs  not  touch  an  OUT  cell)  is  a  FIELD  cell  by  default. 

Since  any  cell  type  (except  OPEN)  can  be  changed  to  any  other  cell  type 
(except  FIELD)  by  subsequent  input,  it  is  possible  to  create  internal  obstacles 
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that  were  not  generated  with  the  original  grid.  Consider  the  following 
hypothetical  INPUT  sequence: 

&INPUT  ITEM=’CELL  TYPES’  &END 

&INPUT  ITEM=’NOSLIP’  ,  11=2  ,  Jl=l  ,  12=19,  J2=l  &END 

&INPUT  ITEM=’SLIP’  ,  11=2  ,  Jl=10,  12=19,  J2=10  &END 

&INPUT  ITEM=’NOSLIP’  ,  11=11,  Jl=3  ,  12=13,  J2=8  &END 

&INPUT  ITEM=’OUT’  ,  11=12,  Jl=4  ,  12=12,  J2=7  &END 

&INPUT  rrEM= ’FLUX’  ,  11=1  ,  Jl=l  ,  12=1  ,  J2=10  &END 

&INPUT  ITEM=’OPEN’  ,  11=20,  Jl=l  ,  12=20,  J2=10  &END 

&INPUT  ITEM=’END’  &END 

In  the  computational  (ij)  plane,  this  INPUT  sequence  creates  an  obstacle 
1  cell  thick  (in  the  i-direction)  and  4  cells  wide  (in  the  j-direction)  inside  a 
grid  with  20  cells  in  the  i-direction  and  10  cells  in  the  j-direction.  The  west 
end  of  the  grid  is  a  FLUX  boundary,  and  the  east  end  is  an  OPEN  boundary. 
Between  the  ends,  the  north  and  south  grid  boundaries  are  SLIP  and  NOSLIP, 
respectively. 

In  its  printed  maps  of  cell  types,  STREMR  uses  the  following  numerals  to 
indicate  the  six  different  types  in  the  computational  plane: 

0  =  OUT  1  =  FIELD  2  =  NOSLIP  3  =  SLIP  4  =  FLUX  5  =  OPEN 

Thus,  for  the  hypothetical  INPUT  sequence  above,  the  map  of  cell  types 
printed  by  STREMR  would  be; 
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Placement  of  Cell  Types 

There  are  limitations  on  the  placement  of  the  various  cell  types.  Some  of 
these  are  rules  that  must  be  followed  if  STREMR  is  to  run  at  all,  while  others 
are  simply  guidelines  that  improve  the  quality  of  computed  results.  Using  the 
same  numerals  as  before  to  indicate  cell  types,  the  rules  and  recommendations 
for  cell  placement  are  given  below: 
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a.  No  HELD  cell  may  touch  an  OUT  cell.  Only  SUP,  NOSLIP,  FLUX, 
and  OPEN  cells  may  touch  an  OUT  cell.  For  example,  STREMR  will 
stop  if  it  encounters  the  following  arrangement  of  cells: 

mil 

10001 

10001 

mil 

b.  SLIP,  NOSLIP,  FLUX,  and  OPEN  cells  are  allowed  only  as  single  rows 
and  columns.  STREMR  will  stop  if  it  encounters  any  of  the  following 
arrangements  of  cells: 

22  33  44444  5  5 

22  33  44444  55  55 

33  44444  555  555 


c.  SLIP  and  NOSLIP  cells  must  touch  at  least  one  OUT  cell.  This 
includes  the  phantom  OUT  cells  that  surround  the  grid  (Figure  4). 
STREMR  will  stop  if  it  encounters  any  of  the  following  arrangements  of 
cells: 
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d.  FLUX  and  OPEN  cells  must  have  at  least  one  entire  face  in  common 
with  an  out  cell.  This  includes  the  phantom  OUT  cells  that  surround  the 
grid  (Figure  4).  STREMR  will  stop  if  it  encounters  any  of  the  following 
arrangements  of  cells: 
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e.  It  is  best  not  to  place  rows  or  columns  of  OPEN  cells  next  to  rows  or 
columns  of  FLUX  cells.  STREMR  may  have  trouble  with  the  following 
arrangements  of  cells: 
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/.  It  is  best  not  to  place  OPEN  cells  next  to  obstacles  and  indentations. 
STREMR  may  have  trouble  with  the  following  arrangements  of  cells: 
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g.  Whenever  possible,  it  is  best  if  OPEN  cells  extend  all  the  way  across  the 
end  of  a  channel  or  the  end  of  a  channel  arm.  For  example,  the  follow¬ 
ing  are  well-placed  distributions  of  OPEN  cells: 
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The  foregoing  maps  of  cell  types  show  only  portions  of  a  hypothetical  grid, 
and  they  show  none  of  the  phantom  OUT  cells  that  always  surround  the  grid 
(Figures  3  and  4).  Remember  that  SLIP  and  NOSLIP  cells  can  be  specified  in 
sections  if  subsequent  input  for  OUT  cells  (by  row,  column,  or  section)  leaves 
only  rows  and  columns  of  SLIP  and  NOSLIP  cells  in  the  resulting  (final) 
configuration.  STREMR  checks  the  final  anangement  of  the  input  cell  types 
and  prints  the  locations  and  types  of  fatally  misplaced  cells. 


Input  for  Quantities  Other  than  Ceil  Types 

The  INTEGER  indices  II,  Jl,  12,  and  J2  are  used  in  general  to  define  rows, 
columns,  lines,  sections,  and  single  cells  in  the  computational  (r,;)  plane.  For 
input  quantities  other  than  cell  types,  however,  the  REAL  (floating-point) 
coordinates  XI,  Yl,  X2,  and  Y2  are  also  used  to  define  lines  and  points  in  the 
Cartesian  (x,y)  plane  as  well. 

VALUES  is  a  one-dimensional  REAL  array  that  is  used  to  specify  floating¬ 
point  input  quantities  such  as  depth,  elevation,  velocity,  and  Manning’s  coeffi¬ 
cient.  The  character  variable  UNITS  indicates  the  units  for  individual  input 
quantities.  Note  that  UNITS  needs  to  be  specified  only  for  each  occurrence  of 
INPUT  in  which  UNITS  is  different  from  lUNITS. 
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General  (Default)  Values 


In  the  second  input  category,  the  namelist  INPUT  is  used  to  specify  general 
values  of  parameters  and  flow  variables  for  the  grid  as  a  whole.  The  INPUT 
namelist  instructions  for  general  values  are  given  in  Table  8.  Thes  '  values 
replace  the  default  values  that  would  otherwise  be  used  by  STREMR.  A 
hypothetical  INPUT  sequence  for  general  values  might  have  the  following 
appearance: 


Table  8 

Instructions  for  INPUT  Namelist  Sequence  to  Specify  General 
Values 

1,  The  opening  INPUT  namelist  for  general  values  contains  only  the  CHARACTER  variable 

ITEM  =  -GENERAL' 

2.  Intermediate  INPUT  namelists  (if  any)  must  contain  ITEM  and  VALUES.  ITEM  indicates  the 
input  quantity,  and  VALUES  gives  its  REAL  value.  The  optional  CHARACTER  vari2ible  UNITS  is 
for  units  other  than  lUNITS, 

Variable  Value  Explanation 

ITEM  = 

■X-VELOCITY- 

X-component  of  velocity  (Default  =  0.0) 

ITEM  = 

Y-VELOCITY- 

Y-component  of  velocity  (Default  =  0.0) 

ITEM  = 

■|-VELOC(TY- 

1-component  of  velocity  (Default  =  0.0) 

ITEM  = 

■J-VELOCITY' 

J-oomponent  of  velocity  (Default  =  0  0) 

ITEM  = 

•FLOWRATE- 

Flowrate  (Default  =1.0) 

ITEM  = 

MANNING' 

Manning's  coefficient  (Default  =  0.0) 

ITEM  = 

'DEPTH' 

Depth  (Default  =  1 .0) 

ITEM  = 

'SURFACE' 

Surface  elevation  (Default  =  1 .0) 

ITEM  = 

'BOTTOM' 

Bottom  elevation  (Default  =  0.0) 

ITEM  = 

DEEPER' 

Constant  added  to  all  STREMR  flow  depths  (Default  = 

0.0) 

ITEM  = 

'VISCOSITY' 

Kinematic  viscosity  (Default  =  0.000001) 

ITEM  = 

GRID' 

UNITS  will  be  specified  for  grid 

VALUES  = 

Single  REAL  value  for  input  quantity 

UNITS  = 

•METRIC 

SI  units  (if  different  from  lUNITS) 

UNITS  = 

'ENGLISH' 

Non-SI  units  (if  different  from  lUNlTS) 

3,  Item  2  must  be  repeated  for  each  general  value  to  bo  specified. 

<t.  The  closing  INPUT  namelist  for  general  values  contains  only  the  CHARACTER  variable 

ITEM  =  END' 
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&INPUT  ITEM=’GENERAL’ 
&INPUTITEM=’FLOWRATE’  , 
&INPUT  ITEM=*DEPTH’ 
&INPUT  rTEM=’I- VELOCITY’  , 
&INPUT  ITEM=’MANNING’  , 
&INPUT  ITEM=’END’ 


&END 

VALUES=20.  &EjmO 
VALUES=1.  &END 
VALUES=1.  &END 
VALUES=0.02  &END 
&END 


With  automatic  interpolation  activated  by  INTERP  =  ’YES’  in  namelist 
BEGIN  (default),  general  values  will  be  imposed  in  all  SLIP,  NOSLIP,  FLUX, 
and  OPEN  cells,  exept  those  where  other  values  have  been  specified  by  subse¬ 
quent  input  (see  below).  Otherwise,  when  INTERP  =  ’NO’,  general  values 
will  be  used  in  all  grid  cells,  exept  those  where  other  values  have  been 
^>ecined  by  subsequent  input. 

Remember  that  when  VGUESS  =  ’NO’  in  namelist  BEGIN  (default), 
STREMR  uses  only  the  input  velocity  components  normal  to  FLUX  and 
OPEN  boundaries  when  it  computes  the  initial  flow  inside  the  grid.  In  this 
case,  the  general  velocity  affects  only  those  FLUX  and  OPEN  cells  for  which 
there  is  no  subsequent  velocity  input.  Otherwise,  when  VGUESS  =  ’YES’,  the 
general  velocity  influences  all  grid  cells  for  which  there  is  no  subsequent 
velocity  input. 

Note  also  that  STREMR  accepts  either  x-  and  y-components  or  i-  and  j- 
components  for  input  velocity  (general  or  otherwise),  depending  on  which  is 
specified  last.  For  example,  if  an  x-component  is  specified  first  and  a  j- 
component  is  specified  afterward,  then  STREMR  uses  only  the  j-component. 

STREMR  accepts  input  values  for  depth  only  when  ELEVAT  =  ’NO’  in 
namelist  BEGIN  (default).  Otherwise,  when  ELEVAT  =  ’YES’,  it  accepts 
input  values  for  surface  and  bottom  elevations  instead  of  depth.  Note  that 
when  ITEM  =  ’DEEPER’,  the  value  specified  for  VALUES  is  a  constant  that 
will  be  divided  by  the  scale  factor  REDUCE  and  added  to  all  depths  otherwise 
resulting  from  the  input  for  depth  or  elevation.  This  allows  users  to  increase 
or  decrease  the  flow  depth  by  the  same  amount  everywhere,  without  having  to 
change  the  rest  of  the  input  for  bathymetry. 

Remember  that  when  KETURB  =  ’YES’  in  namelist  BEGIN  (default), 
STREMR  computes  eddy  viscosity  from  the  turbulence  model,  and  no  general 
value  is  needed  for  viscosity.  Otherwise,  when  KETURB  =  ’NO’,  be  sure  to 
specify  a  general  value  for  viscosity. 


Section  Values 

In  the  third  input  category,  the  namelist  INPUT  is  used  to  specify  values 
for  parameters  and  flow  variables  in  rectangular  sections  of  the  computational 
(i,J)  plane.  The  INPUT  namelist  instructions  for  section  values  are  given  in 
Table  9.  Values  are  assigned  by  rows  (II  to  12),  beginning  with  the  J1  row 
and  ending  wiih  the  J2  row.  Be  careful  that  the  number  of  values  specified 
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Table  9 

instructions  for  INPUT  Namelist  Sequence  to  Specify  Section 
Values 

1.  The  opening  INPUT  namelist  for  section  values  contains  only  the  CHARACTER  variable 

ITEM  =  -SECTION' 

2.  Intermediate  INPUT  namelists  (if  any)  must  contain  ITEM,  VALUES,  and  11 ,  12,  J1 ,  and  J2. 

ITEM  indicates  the  input  quantity.  VALUES  gives  its  REAL  values.  'UNITS  (optional)  is  for  units 
other  than  lUNlTS. 

Variable 

Value 

Explanation 

ITEM  = 

'X-VELOCITY' 

X-component  of  velocity 

ITEM  = 

■Y-VELOCITY 

Y-component  of  velocity 

ITEM  = 

■l-VELOCITY' 

l-component  of  velocity 

ITEM  = 

■J-VELOCITY' 

J-component  of  velocity 

ITEM  = 

•MANNING' 

Manning’s  coefficient 

ITEM  = 

'DEPTH' 

Depth 

ITEM  = 

'SURFACE' 

Surface  elevation 

ITEM  = 

'BOTTOM' 

Bottom  elevation 

11  = 

Smallest  INTEGER  i-index  for  section 

J1  = 

Smallest  INTEGER  j-index  for  section 

12  = 

Largest  INTEGER  i-index  for  section 

J2  = 

Largest  INTEGER  j-index  for  section 

VALUES  = 

Multiple  REAL  values  for  input  quantity 

UNITS  = 

'METRIC 

SI  units  (if  different  from  lUNITS) 

UNITS  = 

'ENGLISH' 

Non-SI  units  (if  different  from  lUNITS) 

3.  Item  2  must  be  repeated  lor  each  different  section  and  for  each  variable  that  is  to  be  assigned 
section  values. 

4.  The  closing  INPUT  namelist  for  section  values  contains  only  the  CHARACTER  variable 

ITEM  =  'END' 

— 

fills  the  section  exactly.  A  hypothetical  INPUT  sequence  for  section  values 
might  have  the  following  appearance: 


&INPUT  ITEM=’SECnON-  &END 

&INPUT  rrEM='DEPTH'  ,  tl=2,  12=7,  il=3,  J2=5,  VALUES=I8»1  2 
&INPUT  ITEM=’MANNING’  ,  11=4,  12=5,  Jl=6.  J2=7, 

VALUES=0.021 ,0.022,0.022,0 .021  &EN  D 
&INPUT  rrEM=’END-  &END 


Note  that  the  input  values  for  the  array  VALUES  can  be  specified 
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sequentially  as  REAL  numbers  separated  by  commas,  and  as  INTEGER 
multiples  of  single  REAL  numbers,  as  shown  above. 


Line  Values 

In  the  fourth  input  category,  INPUT  is  used  to  ^ecify  user-designated 
values  for  parameters  and  flow  variables  along  lines  in  either  the  computa¬ 
tional  (iff)  plane  or  the  Cartesian  (x,y)  plane.  The  INPUT  namelist  instructions 
for  line  values  are  given  in  Table  10.  In  this  case,  the  end  points  must  be 
specified  for  the  line,  along  with  the  re^ective  end-point  values  for  the  input 
quantity.  End  points  for  a  single  line  may  be  specified  as  either  (y}  or  (x,/) 
coordinates,  but  not  both. 

STREMR  uses  linear  interpolation  (with  respect  to  arc  length)  to  distribute 
values  of  the  designated  variable  between  the  two  end  points,  but  the  lines 
connecting  end  points  aie  nut  necessarily  straight  Given  a  pair  of  Cartesian 
(x,y)  end  points,  the  code  finds  two  cells  whose  centers  lie  closest  to  these 
points.  It  then  finds  the  shortest  connection  between  the  centers  of  the  end¬ 
point  cells  in  the  computational  (i,f)  plane.  That  connection  might  be  a  row,  a 
column,  a  diagonal,  or  a  combination  thereof.  The  centers  of  the  connecting 
cells  are  the  interpolation  points  for  the  input  variable.  A  hypothetical  INPUT 
namelist  sequence  for  line  input  might  have  the  following  form: 

&INPUT  ITEM=’UNE’  &END 

&INPUT  rrEM=‘DEPTH’  ,  \U3  ,  Jl=2  ,  I2=t  ,  12*7  ,  VALUES* 1. 10, 0.90  &END 
&INPUT  ITEM* 'MANNING' ,  Xla2.1,  Yl=13,  X2.:o.4,  Y2*0.8,  VALUES=0.01,0.02  &END 
&INPUT  rrEM=’END'  &END 

Note  that  for  line  input,  11  can  be  greater  than  12,  and  J1  greater  than  J2. 
Likewise,  XI  can  be  greater  than  X2,  and  Y1  greater  than  Y2. 


Values  for  Cells  and  Points  at  Random 


In  the  fifdi  input  category,  INPUT  is  used  to  specify  parameters  and  flow 
variables  at  random  for  individual  cells  (IMl)  in  the  computational  plane  and 
for  individual  points  (X1,Y1)  in  the  Cartesian  plane.  The  INPUT  namelist 
instructions  for  random  values  are  given  in  Table  11.  A  hypothetical  namelist 
sequence  for  random  input  might  have  the  following  form; 

&INPUT  ITEM=’RANDOM’  &END 

&INPUT  ITEM=’DEPTH’  ,  Xl=8.6,  Yl=7.9,  VALUES=1.05  &END 
&INPUT  ITErvI=’MANNING’.  11=2  ,  J2=9  ,  VALUES=0.01  &END 
&INPUT  ITEM=’END’  &END 
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Table  10 

Instructions  for  INPUT  Namelist  Sequence  to  Specify  Line  Values 

1 .  The  opening  INPUT  namelist  for  line  values  contains  only  the  CHARACTER  variable 

ITEM  =  -UNE’ 

2.  Intermediate  INPUT  namelists  (if  any)  must  contain  ITEM,  VALUES,  and  the  indices  11,  12,  J1, 
find  J2  (or  the  Cartesian  coordinates  XI,  X2,  Y1,  and  Y2).  In  this  case,  VALUES  gives  the  input 
values  for  the  tvro  end  cells  (I1,J1)  and  (I2,J2)  or  for  the  two  Cartesian  end  points  (XI  ,Y1)  and 
(X2,Y2). 

Variable 

Value 

Explanation 

ITEM  = 

Same  as  for  section  input 

UNITS  = 

Same  as  for  section  input 

VALUES  = 

REAL  values  for  input  quantity  at 
the  two  end  points  of  the  line 

It  = 

INTEGER  i-index  for  cell  containing 
first  end  point 

J1  = 

INTEGER  j-index  for  cell  containing 
first  end  point 

12  = 

INTEGER  i-index  for  cell  containing 
second  end  point 

J2  = 

INTEGER  j-index  for  cell  containing 
second  end  point 

XI  = 

REAL  x-ooordinate  for  first  end  point 

Y1  = 

REAL  y-ooordinate  for  first  end  point 

X2  = 

REAL  x-coordinate  for  second  end  point 

Y2  = 

11! _ -  .  — j 

REAL  y-coordinafe  for  second  end  point 

3.  Item  2  must  be  repeated  for  each  different  line  and  for  each  variable  that  is  to  be  assigned 
line  values. 

4,  The  closing  INPUT  namelist  for  line  values  contains  only  the  CHARACTER  variable 

ITEM  =  ’END' 

Figure  8  shows  Ihc  complete  sequence  of  hypothetical  namelists  for  BEGIN, 
PARAM,  and  INPUT  in  proper  order. 

Execution 

Table  12  summarizes  the  main  steps  carried  out  by  STREMR  for  hot  starts 
and  cold  starts.  With  all  the  namelists  assembled  in  a  command  file  or  an 
input  file,  and  with  the  grid  data  assigned  to  a  second  input  file,  the  user  is 
ready  to  execute  a  flow  calculation. 

When  executing  a  cold  start  (START  =  'COLD')  for  a  new  grid  or  a  new 
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Table  11 

Instructions  for  INPUT  Namelist  Sequence  to  Specify  Random 

Values 

1 .  The  opening  INPUT  namelist  for  random  values  contains  only  the  CHARACTER  variable 

ITEM  =  RANDOM’  | 

2.  Intermediate  INPUT  namelists  (if  any)  must  contain  ITEM,  VALUES,  and  the  indices  11  and  J1 
(or  the  Cartesian  coordinates  XI  and  Y1).  In  this  case,  VALUES  gives  the  value  of  the  input 
quantity  /nthe  cell  (11, J1)  or  af  the  Cartesian  point  (XI, Y1). 

Variable 

Value 

Explanation 

ITEM  = 

Same  as  for  section  input 

UNITS  = 

Same  as  for  section  input 

VALUES  = 

Single  REAL  value  for  input  quantity 

11  = 

INTEGER  i-index  for  grid  cell 

J1  = 

INTEGER  j-index  for  grid  cell 

XI  = 

REAL  x-coordinate  for  Cartesian  point 

Y1  = 

REAL  y-coordinate  for  Cartesian  point 

3.  Item  2  must  be  repeated  for  each  different  cell  or  point  and  for  each  variable  that  is  to  be 
assigned  individual  point  values  or  ceil  values. 

4.  The  closing  INPUT  namelist  for  random  values  contains  only  the  CHARACTER  variable 

ITEM  =  ’END' 

set  of  flow  parameters,  it  is  wise  to  make  the  first  run  with  NSTEPS  =  0. 
STREMR  will  then  calculate  and  store  the  initial  flow,  print  all  information 
requested  by  the  user,  and  stop.  This  is  convenient  for  detecting  errors  in  the 
input,  but  it  works  only  for  cold  starts.  For  hot  starts  (START  =  ’HOT’), 
NSTEPS  =  1  is  the  fewest  number  of  time-steps  permissible. 

Except  when  computing  time-dependent  flow,  it  is  preferable  to  use  a  vari¬ 
able  time-step  (TIMER  =  ’YES’).  Even  for  lime-dependent  flow,  it  is  a  good 
idea  to  make  a  short  test  run  with  a  variable  lime-step  to  find  out  what  the 
fixed  time-step  should  be.  A  longer  run  can  then  be  executed  with  a  fixed 
time-step. 

If  the  real  flow  has  no  steady  state,  as  is  often  the  case  when  obstacles  are 
present,  then  STREMR  should  likewise  reach  no  steady  state.  If  the  real  flow 
does  have  a  steady  sUile,  then  STREMR  should  reach  a  condition  in  which  the 
computed  velocities  hover  about  their  steady-stale  values.  In  the  latter  case, 
there  will  be  no  discernible  change  in  plotted  streamlines,  and  hardly  any 
change  in  plotted  velocity  vectors.  For  practical  purposes  this  is  the  stea(^ 
state.  There  is  little  point  in  further  calculation  when  the  maximum  and  mini¬ 
mum  values  of  velocity  (in  the  condensed  flow  information)  have  remained 
unchanged  for  several  hundred  time-steps. 
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&BEGIM 


&PARAM 


&IKPUT 

&INPUT 

&1NPUT 

&1HPUT 

&1NPUT 

&INPUT 

&I1IPUT 

&INPUT 

ilNPUT 

&INPUT 

WNTOT 

MNPUT 

CiINFirr 

&INPOT 

&INPUT 

&INPUT 

&INPUT 

&INPUT 

«cINm 

Mum 

&INPUT 

&INPUT 

&INPUT 

&1NPUT 

fitlNPUT 

&INPUT 


START- 'COLD' 

FLOW- 'FLOWRATE'  , 
lUNITS- 'METRIC' 

TITLE- 'HYPOTHETICAL  INPUT 


IREF-l, 

JREF-5, 


&END 


PUNITS-' METRIC' 
ALLOUT-'YES' 
MAPS- 'YES' 
TIMER- 'NO' 


NSTEPS-300, 
NSTORE-200, 
NSTOMO-lOO, 
INFORM-IO  . 
ITERS-3  &END 


TURBIN-0.003, 
PECLET-50.  . 


DTIME-O.l, 
RECAP-2.5. 
DRAG-1.0, 
AVIS-1. 0, 


ITEM- 

ITEM- 

ITEM- 

ITEM- 

ITEM- 

ITEM- 

ITEM- 

ITEM- 

ITEM- 

ITEM- 

ITEM- 

ITEM- 

ITEM- 

ITEM- 

ITEM- 

ITEM- 

ITEM- 

ITEM- 

ITEM- 

ITEM- 

ITEM- 

ITEM- 

ITEM- 

ITEM- 

ITEM- 

ITEM- 


CELL  TYPES 
NOSLIP' 
SLIP' 
NOSLIP' 

OUT' 

FLUX' 

OPEN' 

END' 

GENERAL' 

FLOWRATE' 

DEPTH' 

I -VELOCITY' 

MANNING' 

END' 

SECTION' 
DEPTH' 
MANNING'  . 


11-2 

11-2 


Jl-1  , 
Jl-lO, 
11-11,  Jl-3  . 
11-12,  Jl-4  . 
Il-l  .  Jl-1  . 
11-20,  Jl-1  , 


&END 

&END 

&END 

&END 

&END 

&END 


VALUES-20 
VALUES-1. 
VALOES-1. 
VALUES-0.02  &END 
&Qn> 


12-19,  J2-1 
12-19,  J2-10 
12-13,  J2-8 
12-12,  J2-7 
12-1  .  J2-10 
12-20,  J2-10  &END 
&EMD 

&END 

&EMO 

&EMD 

&END 


&END 

&END 


11-2,  12-7,  Jl-3,  J2-5,  VALUES-18*1.2 
11-4,  12-5,  Jl-6,  J2-7, 

VALUES-0. 021, 0.022, 0.022, 0.021  &END 
END'  &END 

LINE'  &END 

DEPTH'  ,  11-3  ,  Jl-2  ,  12-1  ,  J2-7  ,  VALOES-1 . 10 , 0 . 90  &END 

MANNING'  ,  Xl-2.1,  Yl-1.3,  X2-6.4,  Y2-0.8,  VALUES-0. 01, 0.02  &END 
END'  &END 

RANDOM'  &END 

DEPTH'  ,  Xl-8.6,  Yl-7.9.  VAlJOES-1.05  &END 
MANNING',  11-2  ,  J2-9  ,  VALUES-O.Ol  SEND 

END'  &END 


Figure  8.  Complete  sequence  of  hypothetical  namelists  (in  proper  order) 


34 


Chapter  3  STREMR  Input  and  Execution 


Table  12 

STREMR  Operations  for  Cold  Starts  and  Hot  Starts 

CoM  Start 

Hot  Start 

Read  nameHat  BEGIN 

Read  nanrelist  BEGIN 

Read  grid  input  fUa 

Read  nameRst  PARAM 

Read  mvnelist  PARAM 

Execute  flow  calculation  for  specified  number  of  time-stops 
(NSTEPS) 

Read  nameRst  INPUT  for  ceU  types 

Print  coTKlenaed  information  and  calculato  time-stop  size 
at  specified  intervals  (INFORM) 

Read  nameRst  INPUT  for  gerreral 
values 

Print  flow  variables  and  write  output  to  piot  and  hot-start 
files  at  specified  irrtervals  (NSTORE,  NSTOMO) 

Read  nameRst  INPUT  for  section 
values 

Print  maps  of  flow  variables 

Read  nameRst  INPUT  for  line  values 

Read  nameRst  INPUT  for  random 
values 

Execute  flow  calculation  for  specified 
number  of  time-steps  (NSTEPS) 

Print  condensed  information  arxl 
calculate  time-stop  size  at  specified 
intorvais  (INFORM) 

Print  flow  variabies  and  write  output  to 
plot  and  hot-start  files  at  specified 
intorvais  (NSTORE.  NSTOMO) 

Print  maps  of  flow  variabies 

Chapt«r  3  STREMR  Input  and  Execution 
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Types  of  Output 

The  STREMR  code  generates  separate  output  for  printing,  plotting,  and 
subsequent  hot  starts.  Printed  output  appears  on  the  monitor  screen  during 
interactive  execution,  but  it  is  diverted  to  a  default  device  (log  file,  printer, 
etc.)  during  batch  execution.  Data  for  plotting  and  for  subsequent  hot  starts 
are  written  to  separate  output  files. 


Cell-by>Celi  Printout  of  Flow  Variables 

When  ALLOUT  =  ’YES’  in  namelist  BEGIN  (default),  STREMR  prints  a 
complete  cell-by-cell  listing  of  cell-centered  values  for  the  primary  flow  vari¬ 
ables.  When  ALLOUT  =  ’NO’,  STREMR  prints  a  partial  cell-by-cell  listing  if 
the  print  indices  IPMIN,  IPMAX,  JPMIN,  and  JPMAX  are  all  greater  than 
zero  in  namelist  PARAM.  These  are  cell  indices  that  determine  the  southwest 
corner  (1PMIN,JPM1N)  and  the  northeast  corner  (1PMAX,JPMAX)  for  the 
section  of  the  computational  plane  included  in  the  partial  listing.  The  integers 
ISKIP  and  JSKIP  set  the  i-  and  j-intervals  at  which  information  is  printed.  In 
the  order  of  their  appearance,  the  quantities  that  are  printed  are  the  cell  indices 
cell  type,  x-velocity  («),  y-velocity  (v),  resultant  flow  speed  (k^+v^)^^, 
pressure  (p),  depth  (/i),  viscosity  (v),  bottom  friction  factor  (Cj),  turbulence 
energy  per  unit  mass  (k),  rate  of  turbulence  energy  dissipation  per  unit  mass 
(e),  and  Froude  number  {Fr). 

When  PUNITS  =  ’METRIC’  in  namelist  PARAM  (default),  the  printed 
variables  are  given  in  SI  units  with  velocity  in  meters  per  second,  pressure  in 
meters  of  water,  depth  in  meters,  viscosity  in  square  meters  per  second,  energy 
(per  unit  mass)  in  square  meters  per  square  second,  and  energy-dissipation  rate 
(per  unit  mass)  in  square  meters  per  cubic  second.  When  PUNITS  = 
’ENGLISH’,  the  printed  variables  are  given  in  non-Sl  English  units  with 
velocity  in  feet  per  second,  pressure  in  feet  of  water,  depth  in  feet,  viscosity  in 
square  feet  per  second,  energy  (per  unit  mass)  in  square  feet  per  square 
second,  and  energy-dissipation  rate  (per  unit  mass)  in  square  feet  per  cubic 
second. 
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L 

The  bottom  friction  factor  Cy  is  a  dimensionless  function  of  depth  h  and 
Manning’s  coefficient  n  given  in  Appendix  A.  The  Froude  number  Fr  is  the 
dimensionless  ratio  of  local  flow  speed  (resultant  depth-averaged  velocity)  to 
free-surface  wave  speed,  given  by 


Fr 


N 


gh 


(1) 


where  g  is  gravitational  acceleration.  The  printed  viscosity  is  the  local  value 
of  viscosity  (computed  from  the  turbulence  model  or  input  by  the  user),  which 
includes  the  effect  of  the  amplification  factor  AVIS. 


Printout  of  Friction  and  Pressure  Coefficients  for 
Sidewalls 

After  the  cell-by-cell  printout  of  flow  variables  (if  any),  STREMR  prints 
the  sidewall  friction  coefficient  Cr  and  the  sidewall  pressure  coefficient  C„  for 
all  SLIP  and  NOSLIP  boundary  faces  that  were  included  in  the  cell-by-cell 
printout.  The  formulas  for  these  quantities  are  given  by 


(«0^  +  Vq^) 


(2) 


C 


P 


2p 

P(«0^  +  Vq^) 


(3) 


where  p  is  the  pressure,  and  Xq  is  the  sidewall  shear  stress  (Appendix  B)  com¬ 
puted  (for  turbulent  flow)  from  the  turbulence  model  or  (for  laminar  flow) 
from  a  viscous  no-slip  condition.  The  quantities  Uq  and  Vq  are  the  cell- 
centered  velocity  components  in  reference  cell  (IREFJiREF). 

Although  the  same  symbol  Cj-is  used  here  for  bottom  and  sidewall  friction 
coefficients,  both  of  which  arise  from  turbulent  shear  stress,  the  two  quantities 
are  computed  diff^ently  in  STREMR.  The  bottom  friction  coefficient 
accounts  for  the  vertical  influence  of  turbulence  along  the  bottom,  and  it  is 
calculated  from  Manning’s  coefficient  n.  The  sidewall  friction  coefficient 
accounts  for  the  lateral  influence  of  turbulence  along  the  sidewalls,  and  it  is 
calculated  from  the  sidewall  shear  stress  Xj^  produced  by  the  STREMR  version 
of  the  k-t  turbulence  model. 
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Printout  of  Condensed  Flow  Information 

At  user-specified  print  intervals  (INFORM)  and  at  the  end  of  each  storage 
interval  (NSTORE,  NSTOMO),  STREMR  prints  out  condensed  infornration 
about  the  computed  flow.  The  definitions  for  the  printed  symbols  are; 

PMAX  =  maximum  pressure 
PMIN  =  minimum  pressure 
FMAX  =  maximum  Froude  number 
FMIN  =  minimum  Froude  number 
UMAX  =  maximum  x-velocity 
UMIN  =  minimum  x-velocity 
VMAX  =  maximum  y-velocity 
VMIN  =  minimum  y-velocity 
VISMAX  =  maximum  viscosity 
VISMIN  =  minimum  viscosity 

PECMAX  =  maximum  Peclet  number  (cell  Reynolds  number) 

PECMIN  =  minimum  Peclet  number  (cell  Reynolds  number) 

TKEMAX  =  maximum  turbulence  energy 
TKEMIN  =  minimum  turbulence  energy 
EPSMAX  =  maximum  turbulence  dissipation  rate 
EPSMIN  =  minimum  turbulence  dissipation  rate 
SMAX  =  maximum  stream  function 
SMIN  =  minimum  stream  function 
DUAVE  =  average  relative  change  in  x-velocity 
DVAVE  =  average  relative  change  in  y-velocity 
DUMAX  =  maximum  relative  change  in  x-velocity 
DVMAX  =  maximum  relative  change  in  y-velocity 
EMAX  =  maximum  relative  flux  imbalance 
DTMAX  =  new  value  for  maximum  allowable  time-step 
DT  =  time-step  previously  used 

The  Peclet  number  (cell  Reynolds  number)  is  proportional  to  velocity  and 
streamwise  cell  length  and  inversely  proportional  to  viscosity.  For  STREMR 
calculations  without  the  turbulence  model  activated,  the  user-specified  viscosity 
(amplified  by  AVIS)  needs  to  be  large  enough  to  keep  the  Peclet  number 
smaller  than  50  in  flow  regions  with  appreciable  velocity  gradients.  Other¬ 
wise,  there  may  not  be  enough  viscosity  to  prevent  numerical  instability.  For 
STREMR  calulations  with  the  turbulence  model  activated  (default),  the  Peclet 
number  is  not  so  important,  because  eddy  viscosity  is  created  in  response  to 
the  velocity  gradients  themselves.  Nevertheless,  extremely  large  values  for 
PECMAX  (perhaps  greater  than  1000)  just  prior  to  instability  may  indicate  a 
need  for  more  viscosity  or  a  finer  grid. 

STREMR  computes  the  stream  function  only  so  that  streamlines  can  be 
plotted,  and  this  operation  is  not  part  of  the  flow  calculation  itself.  It  is  done 
after  the  fact  (when  flow  information  is  to  be  printed  or  stored)  by  numerical 
integration  of  the  spatial  derivatives 


Chapter  4  STREMR  Output 


=  -hv 


(4) 
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Maximum  and  minimum  values  (SMAX  and  SMIN)  are  printed  for  ip  in  the 
condensed  flow  information.  These  are  intended  to  guide  the  user  in  choosing 
the  range  of  ip  that  is  to  be  included  in  streamline  plots. 

Relative  changes  in  the  cell-centered  velocity  components  are  defined  for  a 
given  lime-step  by  the  relations 


relative  ~  ,  .  =  (6) 
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The  printed  values  DUAVE  and  DVAVE  are  i^atial  averages  of  the  relative 
changes,  and  DUMAX  and  DVMAX  are  the  largest  values  for  the  entire  grid. 

Conservation  of  mass  demands  that  the  net  volumetric  flux  (outflow  minus 
inflow)  be  zero  for  every  cell  of  the  grid.  Expressed  in  terms  of  the  face- 
centered  fluxes  (Figure  2)  for  any  cell  this  means  that 


UiiJ)  ^  V(ij)  -  -  Viij-1)  =  0 


(8) 


To  indicate  the  degree  to  which  Equation  8  is  not  satisfied,  STREMR  uses  the 
relative  flux  imbalance  E  defined  by 


^  _  2\UiiJ)  -  *  VjiJ)  -  V{ij-1)\ 

\u{ij)\  +  \Uii-ij)\  >  |KiV)(  *  in»V-i)l 


(9) 


Thus,  the  relative  flux  imbalance  for  cell  (i,j)  is  the  absolute  difference 
between  volumetric  inflow  and  outflow,  divided  by  the  average  of  the  two. 

The  maximum  relative  flux  imbalance  EMAX  is  the  largest  value  of  E  for 
the  entire  grid.  It  is  an  index  for  convergence  of  the  pressure  calculation,  as 
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well  as  for  conservation  of  mass.  Ordinarily  EMAX  should  be  less  than 
0.02,  but  values  as  high  as  O.OS  may  be  acceptable,  especially  for  transient 
flow.  If  EMAX  consistently  exceeds  0.1,  the  computed  flow  is  no  good;  but  if 
EMAX  eventually  falls  to  0.02  or  less,  then  mass  is  adequately  conserved  for 
most  STREMR  applications.  EMAX  can  usually  be  reduced  by  increasing  the 
number  of  pressure  iterations  ITERS  in  namelist  PARAM,  and  vice  versa. 

The  significance  of  the  other  printed  quantities  should  be  self-evident,  but 
there  is  one  more  point  worth  mentioning.  Due  to  an  alternating  (directional) 
bias  in  the  MacCormack  scheme  for  discretizing  advective  terms  (Appendix  F), 
STREMR  never  converges  to  a  true  steady  state.  Instead,  it  hovers  about  the 
steady  state.  Thus,  no  matter  how  long  the  code  runs,  one  or  more  grid  cells 
may  exhibit  small  (but  noticeable)  changes  in  velocity.  For  this  reason,  the 
velocity  increments  DUAVE,  DVAVE,  DUMAX,  and  DVMAX  may  be  poor 
indicators  of  the  steady  state.  Better  indicators  are  the  velocity  extremes 
UMAX,  VMAX,  UMIN,  and  VMIN,  as  well  as  the  stream-function  extremes 
SMAX  and  SMIN.  The  steady  state  is  at  hand  when  these  quantities  cease  to 
change,  or  when  they  change  ver)'  little  over  several  hundred  time-steps. 


Printed  Maps  of  Flow  Variables 

At  the  end  of  each  run  for  which  MAPS  =  ’YES’  in  namelist  PARAM, 
STREMR  prints  maps  of  the  computational  (i,;)  plane  that  show  the  locations 
of  the  various  cell  types  and  the  relative  magnitudes  of  selected  flow  variables. 
These  maps  run  from  1  to  IMAX  in  the  i-direction,  and  from  1  to  JMAX  in 
the  j-direction.  Internal  OUT  cells  (inside  obstacles  and  indentions)  are  always 
represented  by  the  numeral  0,  but  phantom  OUT  cells  that  surround  the  grid 
(Figure  4)  are  not  shown  at  all. 

The  first  map  to  be  printed  is  the  map  of  cell  types,  in  which  the  following 
numerals  are  used  to  indicate  the  different  types  of  cells: 

O  =  OUT  1  =  FIELD  2  =  NOSLIP  3  =  SLIP  4  =  FLUX  5  =  OPEN 

The  integer  variable  IMAP  in  namelist  PARAM  determines  the  maximum 
length  of  all  maps  in  the  i-direction.  If  IMAX  is  greater  than  IMAP,  then  the 
map  is  terminated  at  i  =  IMAP  and  continued  below  (as  though  it  were  another 
map)  starting  at  i  =  IMAP+1. 

The  next  map  (after  cell  types)  is  that  for  relative  depth,  and  it  is  printed 
only  if  the  depth  is  nonuniform.  The  difference  between  the  maximum  depth 
and  the  minimum  depth  is  divided  into  nine  intervals,  and  the  depth  for  each 
grid  cell  is  indicated  by  map  numerals  ranging  from  1  to  9,  depending  on  the 
particular  interval  in  which  that  depth  falls.  This  same  procedure  is  used  to 
generate  maps  for  the  relative  values  of  other  variables. 

The  map  for  depth  is  followed  by  maps  for  the  bottom  friction  factor, 
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viscosity,  pressure,  turbulence  energy,  turbulence  dissipation  rate,  flow  speed, 
stream  function,  Froude  number,  flux  imbalance,  and  Peclet  number.  If  the 
bottom  friction  is  uniform,  its  map  will  not  be  printed.  If  the  k-t  turbulence 
model  is  not  activated,  there  will  be  no  map  printed  for  viscosity,  turbulence 
energy,  or  dissipation  rate.  If  negative  values  exist  for  stream  function  and 
pressure,  the  map  numeral  9  indicates  the  highest  values  in  a  positive  sense, 
and  the  map  numeral  1  indicates  the  lowest  values  in  a  negative  sense.  Other¬ 
wise,  for  these  and  the  remaining  flow  variables,  the  map  numerals  9  and  1 
indicate  the  largest  and  smallest  values,  respectively,  in  a  positive  sense. 


Output  for  Plots  and  Hot  Starts 

At  user-specified  storage  intervals  given  by  NSTORE  and  NSTOMO  in 
namelist  PARAM,  STREMR  writes  output  (for  plotting)  to  an  external  file 
assigned  by  the  user.  The  first  four  quantities  written  are  TITLE,  IMAX, 
JMAX,  and  NOTIME  (number  of  elapsed  time  steps).  These  are  followed  by 
arrays  for  selected  flow  variables,  which  are  stored  in  the  order  given  below. 
The  FORTRAN  name  for  the  array  is  shown  on  the  left,  and  the  algebraic 


symbol  is 

shown  in  parentheses  on  the  right. 

U 

x-velocity  («) 

V 

y-velocity  (v) 

STRM 

stream  function  (tp) 

DEEP 

depth  (h) 

EDDY 

eddy  viscosity  (v) 

PCO 

pressure  (p) 

TKN 

turbulence  energy  (k) 

TDN 

turbulence-energy  dissipation  rate  (e) 

TYPE 

cell  type 

Each  array  is  written  to  the  plot  output  file  by  a  double  DO-loop  that  runs 
from  1  to  IMAX  (inner  loop)  and  from  1  to  JMAX  (outer  loop)  for  all  quan¬ 
tities  except  the  stream  function  (STRM).  The  DO-loops  for  STRM  run  from 
0  to  IMAX  and  from  0  to  JMAX,  because  STRM  is  computed  at  the  grid 
nodes  instead  of  the  cell  centers.  This  output  file  can  later  be  used  as  input  for 
a  plot  code,  which  must  read  the  stored  information  in  the  same  order  in  which 
it  was  written.  In  the  plot  code,  the  array  dimensions  corresponding  to  IDIM 
and  JDIM  in  STREMR  must  equal  or  exceed  IMAX  +  1  and  JMAX  -t-  1, 
respectively. 

At  the  same  storage  intervals  as  those  for  plot  output,  STREMR  writes 
information  needed  for  hot  starts  to  a  separate  hot-start  output  file.  In  this 
case,  however,  the  output  file  is  overwritten  at  each  storage  interval.  At  the 
end  of  each  run,  only  the  last  hot-start  output  is  available  for  subsequent  hot 
starts.  Note  that  when  reading  a  particular  hot-start  file  in  a  subsequent  run, 
the  STREMR  array  dimensions  IDlM  and  JDIM  must  be  the  same  as  they 
were  when  the  hot-start  file  was  created. 
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5  STREMR  Examples  and 
Verification 


Background 

Examples  of  code  input  and  computed  results  are  presented  in  this  part  to 
offer  prospective  users  a  brief  demonstration  of  what  STREMR  can  do  with 
only  modest  input  All  the  grids  were  generated  with  MESH89,  ^  and  all  the 
plots  were  created  with  PLOT89.^  These  codes  are  not  discussed  in  this 
report,  however,  because  they  are  separate  from  STREMR,  and  they  will  be 
replaced  as  better  software  becomes  available.  In  any  case,  it  is  not  difficult  to 
change  the  STREMR  input/output  format  to  accommodate  a  new  grid 
generator  or  plot  code. 

When  a  grid  is  described  as  a  12  X  8  grid,  this  means  that  the  bounding 
rectangle  for  the  grid  (Figure  3)  covers  12  spaces  in  the  i-direction  and  8 
spaces  in  the  j-direction,  with  its  origin  at  node  (0,0)  in  the  computational  (i,j) 
plane.  There  are  no  units  (other  than  grid  spaces)  for  i  and  /,  and  the  com¬ 
putational  (i,j)  axes  can  point  in  any  direction  in  the  Cartesian  (x,y)  plane.  For 
straight  channels,  it  may  seem  logical  for  the  i-axis  to  point  in  the  x-direction, 
and  for  the  j-axis  to  point  in  the  y-direction;  but  STREMR  works  either  way, 
and  the  Cartesian  orientation  of  the  i-  and  j-axes  is  up  to  the  user. 

The  code  runs  faster  when  IMAX  is  greater  than  JMAX,  rather  than  vice 
versa;  and  it  is  better  to  orient  the  axes  in  the  computational  plane  so  that  the 
greater  number  of  grid  spaces  lies  in  the  i-direction  (Figure  3).  In  all  the 
STREMR  examples,  the  i-direction  is  the  strcamwise  direction  with  respect  to 
the  inflow  (west  boundary),  and  the  general  direction  of  flow  is  from  west  to 
east  (left  to  right)  in  both  the  Cartesian  and  computational  planes.  In  all  cases, 
the  inflow  velocity  is  uniform  and  constant  through  the  west  end  of  the  grid 
(FLUX  boundary),  but  the  outflow  velocity  changes  in  response  to  the  flow 
just  upstream  of  the  east  end  (OPEN  boundary). 


*  Unpublished  grid-generation  code  provided  by  M.  L.  Schneider,  Research  Hydraulic 
Engineer,  August  1989,  US  Army  Engineer  Waterways  Experiment  Station,  Vicksburg,  MS. 

^  Unpublished  plot  code  provided  by  S.  E.  Howington,  Research  Hydraulic  Engineer,  August 
1989,  US  Army  Engineer  Waterways  Experiment  Station,  Vicksburg,  MS. 
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In  principle,  numerical  modelers  should  try  sucessively  finer  grids  until 
there  is  no  further  change  in  predictions  from  one  grid  to  the  next.  In  prac¬ 
tice,  however,  this  needs  to  be  repeated  only  until  the  grid-associated  changes 
fall  to  a  level  that  is  acceptable  for  the  application  under  consideration.  Given 
the  uncertainties  associated  with  bottom  friction,  turbulence,  secondary  flow, 
and  depth-averaged  modeling  in  general,  there  is  little  point  in  further  grid 
refinement  when  reduction  of  the  grid  spacing  (by  a  factor  of  two)  changes  the 
computed  flow  by  less  than  5  percent 

The  first  set  of  examples  (Examples  lA-lJ)  uses  uniform  rectangular  grids 
to  demonstrate  the  computed  influence  of  submerged  and  unsnbmerged  channel 
features,  but  it  does  not  show  how  the  results  change  with  grid  refinement. 

The  second  set  (Examples  2A  and  2B)  employs  nonuniform  rectangular  grids, 
and  demonstrates  the  relative  effects  of  grid  refinement,  bottom  friction,  and 
turbulence  adjustment  on  flow  predictions  for  backsteps  (channel  expansions). 
The  third  set  (Examples  3A  and  3B)  does  likewise  for  unsubmerged  spur 
dikes.  The  fourth  set  (Example  4)  shows  the  effect  of  grid  refinement  on  2-D 
flow  predictions  for  a  gently  curved  surface  (2-D  hill),  and  the  fifth  set 
(Examples  5A-5C)  does  the  same  for  a  more  sharply  curved  surface  (2-D 
circular  cylinder).  The  final  set  (Examples  6A-6C)  demonstrates  the  effect  of 
grid  refinement  on  depth-averaged  velocity  predictions  for  a  double  bendway 
with  a  trapezoidal  cross  section. 

Comparisons  of  STREMR  predictions  and  test  data  aie  included  with 
example  sets  2,  4,  and  6.  Except  for  instances  where  the  relative  influence  of 
the  turbulence  parameter  RECAP  is  demonstrated,  only  the  default  value 
RECAP  =  2.5  was  used  in  the  calculations.  Moreover,  in  all  the  reported 
calculations,  only  default  values  were  used  for  the  following  parameters; 

TURBIN  =  0.003 

PECLET  =  50. 

DRAG  =  1. 

AVIS  =  1. 

ASEC  =  5.0 
DSEC  =  0.5 

In  some  cases,  better  agreement  with  test  data  might  ■  ave  been  obtained  by 
using  values  other  than  the  default  values  for  these  quantities;  but  that  would 
have  been  contrary  to  the  purpose  of  this  report,  which  is  to  show  prospective 
users  what  they  can  expect  to  achieve  without  case-specific  tuning. 

For  the  most  part,  the  namelists  in  the  examples  do  not  show  the 
parameters  and  flow  variables  for  which  default  values  were  used.  This  fea¬ 
ture  of  namelist  format  (that  variables  with  default  values  can  be  omitted) 
leaves  the  input  conveniently  uncluttered.  Any  variable  not  shown  in  name- 
lists  BEGIN  or  PARAM  has  the  default  value  indicated  by  Tables  1-6.  Any 
quantity  not  specified  with  the  general  values  has  the  default  value  indicated 
by  Table  8. 
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The  turbulence  model  and  the  secondary  flow  correction  are  activated  by 
default  in  all  the  STREMR  examples,  but  there  is  no  production  of  secondary 
now  without  bottom  friction.  In  case  there  is  any  confusion  in  recognizing 
plots  for  grids,  streamlines,  and  velocity  vectors,  figures  showing  the  computed 
flow  always  have  the  grid  at  the  top,  the  streamlines  in  the  middle,  and  the 
velocity  vectors  at  the  bottom.  Velocity  vectors  are  shown  for  every  grid  cel! 
in  the  j -direction,  but  not  in  the  i-direction.  The  computed  flows  are  steady, 
exccp*  where  stated  otherwise. 


Example  1A:  Uniform  50  X  12  Grid  for  Straight 
Channel 


Figure  9  shows  a  namelist  sequence  and  its  resulting  map  of  cell  types  for  a 
grid  with  no  bottom  friction  or  depth  variation.  The  flow  region  is  a  straight 
channel,  50  ft  long,  12  ft  wide,  and  1  ft  deep,  for  which  a  uniform  50  X  12 
grid  has  been  generated  (Figure  10).  In  this  case,  the  grid  cells  are  genuinely 
square,  and  the  grid  is  identical  in  both  the  Cartesian  and  computational 
planes.  The  computed  flow  (Figure  10)  is  from  west  to  east,  with  FLUX  cells 
at  the  inflow,  OPEN  cells  at  the  outflow,  and  NOSLIP  cells  elsewhere  along 
the  north  and  south  sidewalls  (by  default).  Since  ti^e  general  value  for  the  x- 
velocity  is  unity,  and  since  no  other  velocities  are  specified,  the  normal 
(inflow)  velocity  remains  constant  along  the  west  end  (FLUX  boundary).  The 
normal  (outflow)  velocity  along  the  east  end  (OPEN  boundary)  changes  in 
response  to  the  developing  flow  just  upstream. 

The  50  X  12  grid  is  much  too  coarse  to  rcoolve  accurately  the  effects  of 
sidewall  shear  stress,  but  it  can  still  capture  the  qualitative  influence  of 
bathymetry,  bottom  friction,  and  sharp-cornered  obstacles.  Subsequent 
examples  (IB-IJ)  demonstrate  the  effects  of  varying  these  channel  features. 

The  variations  are  achieved  through  namelist  input  alone,  with  input  for  cell 
types  used  to  modify  the  50  X  12  grid  shown  in  Figure  9. 


Example  IB:  Uniform  30  X  12  Grid  with  Backstep 

Figure  11  shows  a  namelist  sequence  and  map  of  cell  types  for  a  backstep 
(channel  expansion)  with  no  bottom  friction  or  depth  variation.  Input  for  cell 
types  is  used  to  form  the  expansion  by  creating  a  block  of  NOSLIP  cells  with 
a  smaller  block  of  OUT  cells  inside.  Since  previous  cel!  types  (except  OPEN) 
can  be  changed  to  other  types  (except  FIELD)  by  subsequent  input,  the  final 
configuration  is  a  block  of  OUT  cells  with  a  row  of  NOSLIP  cells  to  the 
north,  and  a  column  of  NOSLIP  cells  to  the  east.  The  modifier!  grid  and  the 
computed  flow  are  shown  in  Figure  12. 
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&BEGIN  START- 'COLD'  .  IREF-1  , 

FLOW- ' INFLOW ■  ,  JREF-7  , 

lUNITS-' ENGLISH'  , 

TITLE- 'EXAMPLE  lAs  50  X  12  GRID'  iEND 
&PARAM  PUNITS-' ENGLISH'  ,  NSTEPS-900  , 
ALLOUT-'YES'  ,  NSTORE-900  , 

MAPS- 'YES'  .  NSTOMO-1 

TIMER- 'YES'  ,  INFORM-10  , 

ITERS-3  SEND 

8.INPUT  ITEM- 'CELL  TYPES' 

&INPUT  ITEM- 'FLUX'  ,  Il-l  ,  12-1  ,  Jl-1,  J2-12 
&INPUT  ITEM- 'OPEN'  ,  11-50,  12-50.  Jl-1,  J2-12 
& INPUT  ITEM- 'END' 

&INPUT  ITEM- 'GENERAL'  iEND 

StINPUT  ITEM- 'DEPTH'  ,  VALUES-1.0  SEND 

&INPUT  ITEM-'X-VELOCITY'  ,  VALUES-1.0  EEND 

iINPUT  ITEM- 'END'  iEND 

&INPUT  ITEM- 'SECTION'  &END 
S. INPUT  ITEM- 'END'  StEND 
& INPUT  ITEM- 'LINE'  SEND 
<« INPUT  ITEM- 'END'  &END 
&INPUT  ITEM- 'RANDOM'  SEND 
&  INPUT  ITEM- 'END'  StEND 


***************  MAP  OF  CELL  TYPES  ************** 
O-OUT  1-FIELD  2-NOSLIP  3-SLIP  4-FLUX  5-OPEN 
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StEND 

StEND 

SEND 

SEND 


Figure  9.  STREMR  input  and  resulting  map  of  cell  types  for  50  x  1 2  grid 
(straight  channel,  no  bottom  friction.  Example  1A) 
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Figure  10.  Uniform  50  x  12  grid  with  computed  streamlines  and  velocity 
vectors  lor  straight  channel  (Example  1A) 

The  flow  separates  from  the  step  precisely  at  the  expansion,  and  it  reat¬ 
taches  to  the  wall  6.2  step  widths  downstream.  The  predicted  realtachment 
point  falls  20  percent  short  of  the  observed  range  for  this  2-D  configuration 
(Durst  and  Tropea  1981),  because  the  grid  is  too  coarse  near  the  step. 

This  brings  up  an  important  point  concerning  STREMR  calculations  in 
particular,  and  numerical  flow  calculations  in  general.  Wherever  the  flow 
encounters  a  sharp  comer,  there  is  some  loss  of  streamwise  momentum  caused 
by  false  (numerical)  diffusion  normal  to  the  flow.  If  the  comer  coincides  with 
a  channel  expansion,  this  momentum  loss  is  compounded  by  a  rise  in  prc.ssure 
(adverse  pressure  gradient)  that  further  retards  the  flow.  The  inevitable  result 
is  that  computed  flows  often  separate  at  abrupt  expansions,  even  when  the  grid 
is  too  coarse  to  resolve  the  downstream  flow  accurately. 
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&BEGIN  START- 'COLD'  .  IREF-1  . 

FLOW- 'INFLOW  ,  JREF-7  , 

lUNITS-' ENGLISH’  , 

TITLE- ■ EXAMPLE  IB;  50  X  12  GRID  WITH  BACKSTEP' 
&PARAM  PUNITS-' ENGLISH'  ,  NSTEPS-900  , 

ALLOUT-'YES'  ,  NSTORE-900  , 

MAPS- 'YES'  ,  NSTOMO-1 

TIMER- 'YES’  ,  INFORM-10  , 


UNITS- 'ENGLISH ■ 
LLOUT-'YES' 
MAPS- 'YES' 
TIMER- 'YES’ 


& INPUT  ITEM- 
&INPUT  ITEM- 
JtINPUT  ITEM- 
& INPUT  ITEM- 


'  NOSLIP' 

-OUT' 

'FLUX’ 


{.INPUT  ITEM- 'OPEN'  .  I 
&INPUT  ITEM- 'END' 

{.INPUT  ITEM- 'GENERAL' 
{.INPUT  ITEM- 'DEPTH' 

{.INPUT  ITEM-’X-VELOCITY* 
{.INPUT  ITEM- 'END' 

&  INPUT  ITEM- ■  SECTION '  {.END 
{.INPUT  ITEM- 'END'  {.END 

{.INPUT  ITEM- 'LINE'  {.END 
{.INPUT  ITEM- 'END'  {.END 


ITERS-3  {.END 

i' 

Il-l  , 

12-6  ,  Jl-1, 

J2-6 

&END 

&END 

Il-l  . 

12-5  ,  Jl-l, 

J2-5 

{.END 

Il-l  , 

12-1  .  Jl-6, 

J2-12 

(.END 

11-50, 

12-50,  Jl-1, 

J2-12 

&END 

{.END 

{.END 

VALUES-1.0  &END 
VALUES-1.0  {.END 
{.END 


&  INPUT  ITEM- 'RANDOM'  {.END 
{.INPUT  ITEM- 'END'  {.END 


***♦★**•★*★****♦  map  OF  CELL  TYPES  ************** 
O-OUT  1-FIELD  2-NOSLIP  3-SLIP  A-FLUX  5-OPEN 
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Figure  11.  STREMR  input  and  resulting  map  of  cell  types  for  50  x  12  grid 

with  backstep  (channel  expansion,  no  bottom  friction,  Example  IB) 
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Example  1C:  Uniform  50  X  12  Grid  with  Forestep 

Figure  13  shows  a  namelist  sequence  and  map  of  cell  types  for  a  forestep 
(channel  contraction)  with  no  bottom  friction  or  depth  variation.  As  before, 
cell  types  have  been  manipulated  to  form  the  contraction  by  creating  a  block 
of  NOSLIP  cells  with  a  smaller  block  of  OUT  cells  inside.  The  final  configu¬ 
ration  is  a  block  of  OUT  cells  with  a  row  of  NOSLIP  cells  to  the  north,  and  a 
column  of  NOSLIP  cells  to  the  west.  The  modified  grid  and  the  computed 
flow  are  shown  in  Figure  14. 
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&BEGIN  START- 'COLD'  ,  IREF-1  , 

FLOW- ' INFLOW '  ,  JREF-7  , 

lUNlTS-' ENGLISH'  , 

TITLE- 'EXAMPLE  1C:  50  X  12  GRID  WITH  FORESTEP'  &END 
{.PARAM  PUNITS-’ ENGLISH'  ,  NSTEPS-900  , 

ALLOUT-'YES'  ,  NSTORE-900  , 


MAPS- 'YES'  ,  NSTOMO-1 

TIMER- 'YES'  ,  INFORM-10  , 


ITERS-3  SEND 

& INPUT 

ITEM- 'CELL  TYPES' 

SEND 

&INPUT 

ITEM-'NOSLIP' 

.  11-16. 

12-50.  Jl-1. 

J2-6 

SEND 

& INPUT 

ITEM- 'OUT' 

.  11-17. 

12=50,  Jl=l, 

J2-5 

SEND 

& INPUT 

ITEM- 'FLUX’ 

,  11-1  . 

12-1  ,  Jl-1, 

J2-12 

SEND 

& INPUT 

ITEM- 'OPEN' 

,  11-50, 

12-50,  Jl-6, 

J2-12 

SEND 

SilNPUT 

ITEM- 'END' 

SEND 

& INPUT 

item- ' GENERAL ' 

SEND 

& INPUT 

ITEM- 'DEPTH' 

.  VALUES-1.0  SEND 

S.  INPUT 

ITEM-'X-VELOCITY'  ,  VALUES-1.0  iEND 

&INPUT 

ITEM- 'END' 

SEND 

& INPUT 

ITEM- 'SECTION' 

SEND 

& INPUT 

ITEM- 'END' 

SEND 

&INPUT  ITEM- 'LINE'  &END 
& INPUT  ITEM- 'END'  iEND 
&INPUT  ITEM- 'RANDOM'  &END 
i INPUT  ITEM- 'END'  5.END 


A***'***********  map  OF  CELL  TYPES  ************** 
O-OUT  1-FIELD  2-NOSLIP  3-SLIP  4-FLUX  5-OPEN 
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Figure  13.  STREMR  input  and  resulting  map  of  cell  types  for  50  x  12  grid  with 
forestep  (channel  contraction,  no  bottom  friction,  Example  1C) 
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Figure  14.  Uniform  50  x  12  grid  with  computed  streamlines  and  velocity 
vectors  for  forestep  (Example  1C) 

The  flow  makes  a  sharp  turn  at  the  contraction,  and  the  streamlines  are 
pushed  away  from  the  wall  downstream.  No  recirculation  occurs,  however, 
contrary  to  experimental  observations  made  for  similar  2-D  configurations  by 
Moss  and  Baker  (1980).  Although  there  is  a  loss  of  streamwise  momentum 
via  numerical  diffusion  as  the  flow  turns  the  comer,  this  is  countered  by  a 
decline  in  pressure  (favorable  pressure  gradient)  that  accelerates  the  (low.  The 
result  in  general  is  that  the  computed  flow  may  not  separate  for  an  abrupt 
contraction  if  the  grid  is  too  coarse,  as  it  is  in  this  case. 
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Example  ID:  Uniform  50  X  12  Grid  with  Square 
Dike 


Figure  15  shows  a  namelist  sequence  and  map  of  cell  types  for  an  unsub¬ 
merged  square  dike  (contraction/expansion)  with  no  bottom  friction  or  depth 
variation.  Input  for  cell  types  is  used  to  form  the  dike  by  creating  a  block  of 
NOSLIP  cells  with  a  smaller  block  of  OUT  cells  inside.  The  final  configura¬ 
tion  is  a  block  of  OUT  cells  with  a  row  of  NOSLIP  cells  to  the  north,  and 
columns  of  NOSLIP  cells  to  the  east  and  west.  The  modified  grid  and  the 
computed  flow  are  shown  in  Figure  16. 

The  grid  is  too  coarse  to  resolve  either  the  flow  separation  at  the  contrac¬ 
tion  or  the  recirculation  observed  along  the  north  side  of  the  dike  (Moss  and 
Baker  1980),  but  it  does  produce  a  recirculating  flow  downstream  of  the 
expansion.  Previous  comments  about  numerical  diffusion  and  pressure  gradi¬ 
ents  (Examples  IB  and  1C)  apply  for  this  example  as  well. 


Example  IE:  Uniform  50  X  12  Grid  with  Square 
Pier 

Examples  lA-lD  all  produce  steady  flow.  In  contrast,  consider  Figure  17, 
which  shows  a  namelist  sequence  and  map  of  cell  types  for  a  square  pier  in  a 
channel  with  no  bottom  friction  or  depth  variation.  For  this  case,  the  cell-type 
input  has  been  manipulated  to  form  the  pier  by  creating  a  block  of  NOSLIP 
cells  with  a  smaller  block  of  OUT  cells  inside.  Hie  final  configuration  is  a 
block  of  OUT  cells  with  rows  of  NOSLIP  cells  to  the  north  and  south,  and 
columns  of  NOSLIP  cells  to  the  east  and  west.  The  modified  grid  and  the 
computed  flow  are  shown  (for  time-step  900)  in  Figure  18.  At  the  time 
shown,  the  wake  has  become  unsteady,  and  a  vortex  street  has  developed 
because  of  the  periodic  shedding  of  eddies  from  opposite  sides  of  the  pier. 

As  long  as  the  damping  effects  of  sidewall  and  bottom  friction  are  not  great 
enough  to  prevent  it,  unsteady  wakes  will  arise  spontaneously  (even  with 
coarse  grids)  in  STREMR  calculations  for  isolated  obstacles  with  sharp  cor¬ 
ners.  For  curved  obstacles  without  sharp  comers,  however,  the  grids  employed 
must  be  fine  enough  to  resolve  adequately  the  points  of  flow  separation. 
Otherwise,  separation  may  occur  so  far  aft  (if  at  all)  that  only  a  steady  wake 
(if  any)  is  generated. 


Example  IF:  Uniform  50  X  12  Grid  with  L>Shaped 
Pier 

Figure  19  shows  a  namelist  sequence  and  map  of  cell  types  for  a  pier 
shaped  like  an  inverted  letter  L  (or  Greek  letter  F)  in  a  channel  with  no  bottom 
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! &BEGIN  START- 'COLD*  T^IREF-l  , 

FLOW- 'INFLOW  ,  JREF-7  , 
lUNITS-' ENGLISH*  . 

TITLE- 'EXAMPLE  ID:  50  X  12  GRID  WITH  SQUARE  DIKE'  4END 
&PARAM  PUNITS-' ENGLISH'  ,  NSTEPS-900  . 

ALLOUT-'YES'  ,  MSTORE-900  , 

MAPS- 'YES'  ,  NSTOMO-1 

TIMER- 'YES'  .  INFORM-10  , 


ITERS-3  {.END 

& INPUT 

ITEM- 'CELL  TYPES' 

&END 

& INPUT 

ITEM- 'NOSLIP' 

.  11-16, 

12-22,  Jl-1, 

J2-6 

&END 

& INPUT 

ITEM- 'OUT' 

.  11-17, 

12-21,  Jl-1, 

J2-5 

{.END 

& INPUT 

ITEM- 'FLUX' 

,  Il-l  , 

12-1  ,  Jl-1, 

J2-12 

SEND 

&INPUT 

ITEM- 'OPEN' 

.  11-50, 

12-50,  Jl-1, 

J2-12 

{.END 

S INPUT 

ITEM- 'END' 

{.END 

{.INPUT 

ITEM- 'GENERAL' 

{.END 

MNPUT 

ITEM- 'DEPTH' 

,  VALUES-1.0  &END 

{.INPUT 

ITEM- 'X- VELOCITY'  ,  VALUES-1.0  {.END 

{.INPUT 

ITEM- 'END' 

{.END 

{.INPUT 

ITEM- ' SECTION ' 

&END 

{.INPUT 

ITEM- 'END' 

{.END 

&INPUT 

ITEM- 'LINE'  SEND 

ilNPUT 

ITEM- 'END'  {.END 

{.INPUT 

ITEM- 'RANDOM' 

{.END 

{.INPUT 

ITEM- 'END' 

6END 

***************  jijAp  OF  CELL  TYPES  ************** 
O-OUT  1-FIELD  2-NOSLIP  3-SLIP  4-FLUX  5-OPEN 
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Figure  15.  STREMR  input  and  resulting  map  of  celi  types  for  50  x  12  grid  with 
square  dike  (contraction/expansion,  no  bottom  friction,  Example  1 D) 
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Figure  16.  Uniform  50  x  12  grid  with  computed  streamlines  and  velocity 
vectors  for  square  dike  (Example  1 D) 


friction  or  depth  variation.  Once  again,  input  for  cell  types  is  used  to  form  the 
pier,  this  time  with  3X6  and  6X3  sections  of  NOSLIP  cells,  followed  by  a 
4X1  row  and  a  1  X  4  column  of  OUT  cells.  Like  the  previous  case,  this 
example  also  develops  an  unsteady  wake  with  a  vortex  street.  The  modified 
grid  and  computed  flow  are  shown  (for  time-step  900)  in  Figure  20. 


Example  1G:  Uniform  50  X  12  Grid  with  V- 
Shaped  Bottom 

Examples  lA-lF  do  not  include  the  effects  of  bottom  friction  and  variable 
bathymetry.  Figure  21  shows  a  namelist  sequence  and  map  of  computed 
depths  for  a  straight  channel  with  a  V-shaped  cross  section.  An  exaggerated 
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&BEGIN  START- 'COLD'  ,  IREF-1  , 

FLOtf-' INFLOW'  ,  JREF-7  , 
lUNITS-' ENGLISH'  , 

TITLE- ' EXAMPLE  IE;  50  X  12  GRID  WITH  SQUARE  PIER'  SEND 
ScPARAM  PUNITS-' ENGLISH'  ,  NSTEPS-900  , 


ALLOUT- ' YES ' 

,  NSTORE-900 

• 

MAPS- ' YES • 

,  NSTOMO-1 

« 

TIMER- 'YES' 

,  INFORM-1 0 

t 

ITERS-3 

&END 

& INPUT 

ITEM- 'CELL  TYPES' 

ScEND 

&INPUT 

ITEM- 'NOSLIP'  , 

11-17, 

12-22, 

Jl-4, 

J2-9 

&END 

ScINPUT 

ITEM- 'OUT' 

11-18, 

12-21, 

Jl-5, 

J2-8 

ScEND 

ScINPUT 

ITEM- 'FLUX' 

11-1  , 

12-1  , 

Jl-1, 

J2-12 

SiEND 

ScINPUT 

ITEM- 'OPEN' 

11-50, 

12-50, 

Jl-1, 

J2-12 

ScEND 

ScINPUT 

ITEM- 'END' 

ScEND 

ScINPUT 

ITEM- 'GENERAL' 

ScEND 

ScINPUT 

ITEM- 'DEPTH' 

,  VALUES-1. 

0  &END 

&INPUT  ITEM-'X-VELOCITY'  ,  VALUES-1.0  &END 

&INPUT  ITEM- 'END'  SEND 

SrINPUT  ITEM- 'SECTION'  &END 

&INPUT  ITEM- 'END'  WEND 

&INPUT  ITEM- ’LINE'  SEND 

ScINPUT  ITEM- 'END'  &END 

&INPUT  ITEM- 'RANDOM'  &END 

S> INPUT  ITEM- 'END'  ScEND 


***************  OF  CELL  TYPES  ************** 
O-OUT  1-FIELD  2-NOSLlP  3-SLIP  A-FLUX  5-OPEN 
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Figure  17.  STREMR  input  and  resulting  map  of  cell  types  for  50  x  12  grid 
with  square  pier  (no  bottom  friction,  Example  IE) 
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Figure  18.  Uniform  50  x  12  grid  with  computed  streamlines  and  velocity 
vectors  for  square  pier  (Example  IE,  unsteady,  time-step  900) 

view  of  the  bottom  bathymetry  (looking  upstream)  is  given  in  Figure  22, 
which  shows  only  the  bottom  of  the  channel. 

Note  the  manner  in  which  the  V-shaped  bottom  is  created  with  the  line 
input  for  depth.  After  the  INPUT  namelist  with  ITEM  =  ’LINE’,  there  are  two 
INPUT  namelists  with  ITEM  =  ’DEPTH’.  These  .set  the  depth  at  0.2  ft  along 
the  north  and  south  sides  (J  =  1  and  J  =  12).  Next  come  two  similar  namelists 
for  the  west  and  cast  ends  of  the  channel  (1=1  and  I  =  50),  which  interpolate 
the  depth  from  0.2  ft  at  J  =  1  to  1.0  ft  at  J  =  6.  Then  come  two  namclisLs  that 
fix  the  depth  at  1 .0  ft  in  the  two  rows  of  cells  (J  =  6  and  J  =  7)  adjacent  to  the 
centerline.  Finally  come  two  more  namelists  for  the  ends  of  the  channel  (I  =  1 
and  I  =  50),  which  interpolate  the  depth  from  1.0  ft  at  J  =  7  to  0.2  ft  at  J  = 
12.  The  automatic  interpolation  scheme  fills  in  the  remaining  depths  for  the 
grid.  The  Manning  coefficient  is  uniformly  set  at  0.03  to  produce  a  strong 
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SBEGIN  START- 'COLD'  ,  IREF-1  , 

FLOW- ’INFLOW  ,  JREF-7  , 
lUNITS-' ENGLISH'  , 

TITLE- ' EXAMPLE  IF;  50  X  12  GRID  WITH  GAMMA  PIER'  SEND 
&PARAM  PUNITS-’ ENGLISH'  ,  NSTEPS-900  , 


ALLOUT-'YES'  ,  NSTORE-900  , 

MAPS- 'YES'  ,  NSTOMO-1 

TIMER- 'YES'  ,  INFORM- 10  , 


ITERS-3  SEND 

&INPUT 

ITEM- 'CELL  TYPES' 

{■END 

& INPUT 

ITEM- ' NOSLIP ’  , 

11-17, 

12-19,  Jl-4, 

J2-9 

{■END 

i INPUT 

ITEM- 'NOSLIP'  , 

11-17, 

12-22,  Jl-7, 

J2-9 

&END 

StINPUT 

ITEM- ' OUT ' 

11-18, 

12-18,  Jl-5, 

J2-8 

&END 

& INPUT 

ITEM- 'OUT' 

11-18, 

12-21,  Jl-8, 

J2-8 

{.END 

&INPUT 

ITEM- 'FLUX' 

Il-l  . 

12-1  ,  Jl-1, 

J2-12 

{■END 

{■INPUT 

ITEM- 'OPEN' 

11-50, 

12-50,  Jl-1, 

J2-12 

&END 

{■INPUT 

ITEM- 'END' 

{■END 

{■INPUT 

ITEM- 'GENERAL' 

{.END 

{■INPUT 

ITEM- 'DEPTH' 

,  VALUES-1.0  iEND 

SclNPUT  ITEM- '  X-VELOCITY '  ,  VALUES-1.0  SEND 

&1NPUT  ITEM- 'END'  SEND 

&INPUT  ITEM- 'SECTION'  iEND 

ilNPUT  ITEM- 'END'  &END 

SINPUT  ITEM- 'LINE'  SEND 

J. INPUT  ITEM- 'END'  &END 

S-INPUT  ITEM- '  RANDOM  •  SEND 

S.INPUT  ITEM- 'END'  SEND 


***************  map  of  cell  TYPES  ************** 
O-OUT  1-FIELD  2-NOSLIP  3-SLIP  4-FLUX  5-OPEN 
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Figure  19.  STREMR  input  and  resulting  map  of  cell  types  for  50  x  12  grid  with 
L-shaped  pier  (no  bottom  friction,  Example  IF) 
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Figure  20.  Uniform  50  x  12  grid  computed  streamlines  and  velocity  vectors 
for  L-shaped  pier  (Example  1 F,  unsteady,  time-step  900) 

bottom-friction  influence,  and  the  computed  flow  is  shown  with  the 
unmodified  grid  in  Figure  23. 

Although  the  lateral  distribution  of  velocity  undergoes  a  gradual  transition 
from  uniform  to  parabolic,  the  streamlines  are  consistently  more  widely  spaced 
next  to  the  sides  of  the  channel  than  in  the  middle.  In  this  example,  the  varia¬ 
tion  in  streamline  spacing  arises  more  from  nonuniform  depth  than  from  non- 
uniform  velocity.  Recall  that  STREMR  must  integrate  Equations  4  and  5  to 
obtain  the  stream  function  tp.  In  these  equations,  the  derivatives  of  tp  are 
proportional  to  the  local  depth  h.  As  a  result,  for  a  channel  with  nonuniform 
depth,  the  streamlines  may  be  unevenly  spaced  even  when  the  velocity  is 
uniform. 
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i BEGIN  START- 'COLD'  ,  IREP-1  , 

FLOW- ’ FLOWRATE ' ,  JREF-7  . 

IUNITS-' ENGLISH'  . 

TITLE- 'EXAMPLE  IG:  50  X  12  GRID  WITH  V-SHAPED  BOTTOM'  iEND 
&PARAM  PUNITS-’ ENGLISH'  ,  NSTEPS-900  . 

ALLOUT-'YES'  .  NSTORE-900  . 

MAPS- 'YES'  ,  NSTOMO-1 
TIMER- 'YES'  .  INFORM-10  , 

ITERS- 3  SEND 


SiINPUT 

ITEM- 'CELL  TYPES' 

(END 

SiINPUT 

ITEM- 'FLUX'  . 

Il-X  , 

12-1  .  Jl-1.  J2 

-12  (END 

6 INPUT 

ITEM- 'OPEN'  , 

IX-50, 

12-50.  Jl-1.  J2 

-12  (END 

(INPUT 

ITEM- 'END' 

(END 

(INPUT 

ITEM- 'GENERAL' 

(END 

(INPUT 

ITEM- 'DEPTH' 

• 

VALUES-1 

.  0  (END 

(INPUT 

ITEM- 'MANNING' 

« 

VALUES-0 

.03  (END 

(INPUT 

ITEM-'X-VELOCITY'  . 

VALOES-1 

.  0  (END 

(INPUT 

ITEM- 'FLOWRATE 

• 

VALOES-12.0  (END 

(INPUT 

ITEM- 'END' 

(END 

(INPUT 

ITEM- 'SECTION' 

(END 

(INPUT 

ITEM- 'END' 

(END 

(INPUT 

ITEM- 'LINE' 

(END 

(INPUT 

ITEM- 'DEPTH'  . 

IX-1 

,  12-50, 

Jl-1  . 

J2-1  , 

VALUES-0. 2, 0.2 

(END 

(INPUT 

ITEM- 'DEPTH*  . 

IX-X 

,  12-50. 

Jl-12. 

J2-12, 

VALUES-0. 2, 0.2 

(END 

(INPUT 

ITEM- 'DEPTH'  . 

Il-l 

,  12-1  , 

Jl-1  , 

J2-6  . 

VALUES-0. 2, 1.0 

(END 

(INPUT 

ITEM- 'DEPTH*  , 

11-50,  12-50, 

Jl-1  , 

J2-6  . 

VALUES-0. 2, 1.0 

(END 

(INPUT 

ITEM- 'DEPTH*  , 

IX-1 

.  12-50, 

Jl-6  , 

J2-6  . 

VALUES-1. 0,1.0 

(END 

(INPUT 

ITEM- 'DEPTH'  , 

lX-1 

,  12-50, 

Jl-7  , 

J2-7  , 

VALUES-1. 0,1.0 

(END 

(INPUT 

ITEM- 'DEPTH*  . 

Il-l 

,  12-1  , 

Jl-7  . 

J2-12. 

VALUES-1. 0,0. 2 

(END 

(INPUT 

ITEM- 'DEPTH*  . 

11-50,  12-50, 

Jl-7  , 

J2-12. 

VALUES-1. 0,0. 2 

(END 

(INPUT 

ITEM- 'END' 

(END 

(INPUT 

ITEM- 'RANDOM' 

(END 

(INPUT 

ITEM- 'END' 

(END 

***  MAPS  OF  RELATIVE  VALUES  OF  FLOW  VARIABLES 
0  -  NO-FLOW  CELLS  (TYPE  -  OUT) 

1  -  LOWEST  VALUES  IN  NEGATIVE  SENSE 
9  -  HIGHEST  VALUES  IN  POSITIVE  SENSE 


**♦*  DEPTH  **** 
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Figure  21.  STREMR  input  and  resulting  map  of  depths  for  50  x  12  grid  with 
V-shaped  bottom  (friction  included,  Example  1G) 
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Figure  22.  Exaggerated  bathymetry  (looking  upstream)  for  straight  channel 
with  V-shaped  bottom  (Example  1 G) 


Example  1H:  Uniform  50  X  12  Grid  with  Bottom 
Transition 

In  this  example,  both  section  input  and  line  input  are  used  to  create  a  tran¬ 
sition  from  V-shape  to  rectangular  cross  section.  Figure  24  shows  the  namelist 
sequence  and  the  resulting  map  of  depths,  and  Figure  25  offers  an  exaggerated 
view  of  the  bottom  bathymetry  (looking  upstream).  The  section  input  creates  a 
rectangular  area  of  constant  depth  (flat  bottom)  next  to  the  east  end  (outflow 
boundary),  and  the  line  input  specifies  dqiths  along  the  entrance,  sidewalls, 
and  centerline,  upstream  of  the  flat  bottom.  Automatic  interpolation  for  the 
remaining  depths  produces  a  V-shaped  cross  .section  at  the  entrance,  followed 
by  a  gradual  transition  to  the  flat  bottom.  The  Manning  coefficient  is 
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Figure  23.  Uniform  50  x  12  grid  with  computed  streamlines  and  velocity 
vectors  for  V-shaped  bottom  (Example  1G) 

uniformly  set  at  0.03,  and  the  computed  flow  is  shown  with  the  unmodified 
grid  in  Figure  26. 

As  in  the  previous  example,  the  velocity  distribution  makes  a  gradual  tran¬ 
sition  from  uniform  to  parabolic.  The  lateral  variation  is  greatest  just  upstream 
of  the  flat  section,  but  it  becomes  somewhat  less  nonuniform  by  the  time  it 
reaches  the  outllow.  The  latter  change  occurs  because  the  deceleration  caused 
by  bottom  friction  is  less  nonuniform  with  a  flat  bottom  than  with  a  V-shaped 
bottom. 


Chapter  5  STREMR  Examples  and  Verification 


kSEClN  START- 'COLD'  .  IRIF-1  . 

FLOR- ■  FLOWRATE '  .  JllEF-7  . 
lUNITS-' ENGLISH'  . 

TITLE- 'EXAMPLE  IH:  50  X  12  GRID  WITH  TRANSITION  FROM  V-SHAPE  TO  FLAT  BOTTOM'  lEND 
SPARAM  PUHITS-' ENGLISH'  ,  HSTEPS-900  . 

ALLOUT-'TES'  ,  NSTORE-900  . 

MAPS-'YES'  ,  NSTOMO-I 

TIMER- 'YES'  .  INFORM-IO  , 

ITERS-3  SEND 


S INPUT  ITEM- 'CELL  TYPES'  SEND 

SINPUT  ITEM-'FLOX'  .  Il-l  .  12-1  .  Jl-1.  J2-12  SEND 

SIHPUT  ITEM-'OPEN'  .  11-50.  12-50.  Jl-I.  J2-12  SEND 

SINPUT  ITEM- 'END'  SEND 

SINPUT  ITEM- 'GENERAL'  SEND 

SINPUT  ITEM-'DEPTH-  .  WALUES-1.0  SEND 

SINPUT  ITBM-'X-VELOCITY'  .  VALUES-1.0  SEND 

SIHPUT  ITEM- 'FLOWRATE'  .  VALUES-12.0  SEND 

SINPUT  ITEM- 'MANNING'  .  VALUES-0.03  SEND 

SINPUT  ITEM- 'END'  SEND 

SINPUT  ITEM- 'SECTION' 


SEND 


SINPUT 

ITEM-'DEPTH' 

.  11-41. 

12-50.  Jl-1. 

J2-12, 

VALUES-120-1.0  SEND 

SINPUT 

ITEM- 'END' 

SEND 

SINPUT 

ITEM- 'LINE' 

SEND 

SINPUT 

ITEM-'DEPTH' 

.  11-1  . 

12-20.  Jl-1 

,  J2^1  . 

VALUES-0.2,0.2 

SEND 

SINPUT 

ITEM-'DEPTH' 

.  Il-l  , 

12-20.  Jl-12 

.  J2^12, 

VALUES-0.2.0.Z 

SEND 

SIHPUT 

ITEM-'DEPTH’ 

.  11-1  . 

12-1  .  Jl-1 

.  J2«6  , 

VALUES-a.2,1.0 

SEND 

SIHPUT 

ITEM-'DEPTH’ 

.  11-20. 

12-20.  Jl-1 

,  J2«6  . 

VALUBS-0.2,1.0 

SEND 

SINPUT 

ITEM-’DEPTH' 

.  Il-l  . 

12-40.  Jl-6 

.  J2»6  , 

VALUBS-1. 0,1.0 

SEND 

SIHPUT 

ITEM-'DEPTH’ 

,  Il-l  , 

12-40.  Jl-7 

.  J2»7  , 

VALDXS-1. 0.1.0 

SEND 

SINPUT 

ITEM-'DEPTH’ 

.  Il-l  , 

12-1  ,  Jl-7 

,  J2-12. 

VALUES-1.0. 0.2 

SEND 

SIHPUT 

ITEM-’DEPTH' 

,  11-20. 

12-20,  Jl-7 

.  J2-12. 

VALUES-1.0, 0.2 

SEND 

SINPUT 

ITEM-'DEPTH' 

.  11-21. 

12-41.  Jl-1 

.  J2-1  . 

VALDES-0.2.1.0 

SEND 

SINPUT 

ITEM-'DEPTH' 

.  11-21. 

12-41.  Jl-12 

,  J2-12, 

VALDBS-0.2,1.0 

SEND 

SINPUT 

ITEM- 'END' 

SEND 

SINPUT 

ITEM- 'RANDOM' 

SEND 

SINPUT 

ITEM- 'END’ 

SEND 

•••  HAPS  OF  RELATIVE  VALUES  OF  FLOW  VARIABLES 
0  -  NO-FLOW  CELLS  (TYPE  -  OUT) 

I  •  LOWEST  VALUES  IN  NEGATIVE  SENSE 
9  -  HIGHEST  VALUES  IN  POSITIVE  SENSE 


DEPTH  *»*» 


1I111111II11III11II11112233S455S6S77B8999999999999 
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Figure  24.  STREMR  input  and  resuKing  map  of  depth  for  50  x  12  grid  wwith 
transition  from  V-shape  to  flat  bottom  (friction  included, 

Example  IH) 
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Figure  25.  Exaggerated  bathymetry  (looking  upstream)  for  straight  channel  with 
transition  from  V-shape  to  flat  bottom  (Example  1 H) 

Example  11:  Uniform  50  X  12  Grid  with  Uneven 
Bottom 

Figure  27  shows  the  namelist  sequence  and  resulting  map  of  depths  for  a 
straight  channel  with  an  uneven  bottom.  Unlike  Examples  IG  and  IH,  which 
used  only  the  cell  indices  (11,11)  and  (12^2)  to  specify  line  input  for  depth, 
this  example  uses  the  Cartesian  coordinates  (XI, Yl)  and  (X2,Y2)  as  well, 
employing  both  line  input  and  random  input  to  create  the  uneven  bottom. 
Figure  28  gives  an  exaggerated  view  of  the  bottom  bathymetry  (looking 
upstream).  Automatic  interpolation  produces  smooth  transitions  between  the 
peaks,  troughs,  and  ridges  specified  in  the  namelist  input  The  Manning 
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Figure  26.  Uniform  50  x  12  grid  with  computed  streamlines  and  velocity 
vectors  for  transition  from  V-shape  to  flat  bottom  (Example  1H) 

coefficient  is  uniformly  set  at  0.03,  and  the  computed  flow  is  shown  with  the 
unmodified  grid  in  Figure  29. 

The  uneven  bottom  has  a  very  noticeable  effect  on  the  predicted  flow. 

Most  dramatic  is  the  influence  of  the  ridge  near  the  upstream  boundary  (Fig¬ 
ure  28),  which  diverts  the  flow  toward  either  side  (Figure  29)  and  changes  the 
nearby  velocities  quite  abruptly.  It  also  creates  a  wake  that  persists  for  some 
distance  downstream.  The  other  submerged  features,  including  the  bumps  near 
the  downstream  boundary  (Figure  28),  seem  to  have  a  lesser  effect 
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tBEGIH  START- 'COLD-  .  IREP-1  . 

FLOW- ’ FLOWRATE • ,  JtEF-7  , 
lUNlTS-' ENGLISH*  , 

TITLE- ' EXAMPLE  lit  50  X  12  GRID  WITH  UNEVEN  BOTTOM'  SEND 
SPARAH  FUHITS-' ENGLISH'  ,  MSTEPS-900  , 

ALLOUT-'TES'  .  MSTOXE-900  . 

MAPS- 'YES'  ,  NSTOMO-1 
TIMER- 'YES'  .  IHFORM-10  . 

ITERS-3  SEND 

SIHPUT  ITEM- 'CELL  TYPES'  SEND 

tINPUT  ITEM- 'FLUX'  .  Il-l  .  12-1  .  Jl-1.  J2-12  SEND 
SINPUT  ITEM-'OPEN'  .  11-50,  12-50,  Jl-1,  J2-12  SEND 


SINPUT 

ITEM- 'END- 

SEND 

SINPUT 

ITEM-  ‘GENERAL  ' 

SEND 

SINPUT 

ITEM- 'DEPTH' 

,  VALUES-0.5 

SEND 

SINPUT 

ITEM-'X-VELOCITY'  ,  VALDES-1.0 

SEND 

SINPUT 

ITEM- 'FLOWRATE 

'  ,  VALOES-12.0 

SEND 

SINPUT 

ITEM- 'MANNING ' 

,  VALUES-0.03 

SEND 

SINPUT 

ITEM-'END' 

SEND 

SINPUT 

ITEM-' SECTION ' 

SEND 

SINPUT 

ITEM-'END' 

SEND 

SINPUT 

ITEM- 'LINE- 

SEND 

SINPUT 

ITEM-'  DEPTH'  , 

XI-  0.3,  Yl-1.7, 

X2-11.9, 

Y2-8.4, 

VALUES-0. 5, 0.1 

SEND 

SINPUT 

ITEM- 'DEPTH'  , 

Xl-12.6,  Yl-7.8, 

X2-36.2, 

Y2-6.7, 

VALUES-0. 1,1.0 

SEND 

SINPUT 

ITEM- 'DEPTH'  , 

Xl-37.5,  Yl-5.9, 

X2-48.4, 

Y2-9.1, 

VALUES-l.O.O.S 

SEND 

SINPUT 

ITEM- 'END' 

SEND 

SINPUT 

ITEM- -RANDOM ■ 

SEND 

SINPUT 

ITEM- 'DEPTH'  , 

11-30  ,  Jl-8  , 

VALUES-0 

.1  SEND 

SINPUT 

ITEM- 'DEPTH'  , 

11-41  ,  Jl-5  , 

VALUES-0 

.2  SEND 

SINPUT 

ITEM- 'DEPTH'  , 

XI-  6.7,  Yl-7.5, 

VALUES-0 

.9  SEND 

SINPUT 

ITEM- 'DEPTH'  , 

Xl-15.3,  Yl-2.3, 

VALUE5-0 

.7  SEND 

SINPUT 

ITEM- 'END' 

SEND 

***  MAPS  OF  REUTIVE  VALUES  OF  FLOW  VARIABLES  ••• 

0  -  NO-FLOW  CELLS  (TYPE  -  OUT) 

1  •  LOWEST  values  IN  NEGATIVE  SENSE 
9  -  HIGHEST  VALUES  IN  POSITIVE  SENSE 

depth  •*** 
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444333333333344S44444445555566666677766S4455555S54 

44444444444444365544444555555556666666554455555554 

44444444444444555544444555555555555555555455555554 
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Figure  27.  STREMR  input  and  resulting  map  of  depths  for  50  x  12  grid  with 
uneven  bottom  (friction  included,  Example  II) 
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Figure  28.  Exaggerated  bathymetry  (looking  upstream)  for  straight  channel  with 
uneven  bottom  (Example  1 1) 


Example  1J:  Uniform  50  X  12  Grid  with  Square 
Pier  and  Bottom  Transition 

This  example  combines  namelist  input  for  cell  type  and  depth  to  create  a 
transition  from  V-shape  to  flat  bottom  in  a  straight  channel,  with  a  square  pier 
in  the  transition.  Figure  30  gives  the  namelist  sequence,  and  Figure  31  shows 
the  resulting  maps  of  cell  types  and  d^ths.  Figure  32  offers  an  exaggerated 
view  of  the  bottom  bathymetry  (looking  upstream),  in  which  the  dark  rectangle 
rqiresents  the  base  of  the  pier.  The  Manning  coefficient  is  uniformly  set  at 
0.03,  and  the  computed  flow  is  shown  with  the  modified  grid  in  Figure  33. 

Recall  that  in  Example  IE,  the  square  pier  produced  an  unsteady  wake 
(vortex  street)  in  a  straight  channel  with  a  flat  bottom  and  no  bottom  friction 
(Figure  18).  In  the  present  case,  however,  the  wake  is  only  slightly  unsteady 
(and  slightly  asymmetric),  because  the  bottom  friction  imposes  a  damping 
influence  strong  enough  here  to  prevent  vortex  shedding. 

Example  2A:  Nonuniform  60  X  30  Grid  with 
Backstop 

This  example  employs  a  nonuniform  60  X  30  grid  for  a  channel  30  ft  long 
and  0.2  ft  deep.  The  grid  (as  originally  gent  rated)  is  rectangular,  but  cell-type 
designations  are  used  in  the  STREMR  input  (Figure  34)  to  create  a  grid  with  a 
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Figure  29.  Uniform  50  x  12  grid  with  computed  streamlines  and  velocity 
vectors  for  uneven  bottom  (Example  1 1) 

backstep  (expansion)  10  ft  from  the  west  (inflow)  boundary.  The  north  side  of 
the  grid  (Figure  35)  is  designated  as  a  SLIP  boundary  (channel  centerline)  in 
the  STREMR  input.  The  resulting  grid  widths  (channel  half  widths)  are, 
respectively,  Hj  =  10  ft  and  H2  =  11  ft  upstream  and  downstream  of  the  step. 
The  channel  expansion  ratio  is  H2/HJ  =  1.1,  and  the  step  width  is  H  =  H2  - 
Hi  =  1  ft 


Although  the  grid  is  nonuniform  far  from  the  step,  the  grid  cells  arc  per¬ 
fectly  square  in  the  immediate  vicinity  of  the  step.  The  step  width  itself  is 
divided  into  ten  equal  grid  spaces  (0.1  ft  each),  and  the  grid  spacing  gradually 
increa.ses  with  distance  from  the  step  (in  both  directions).  The  resulting  flow 
(no  bottom  friction)  is  shown  with  the  modified  60  X  30  grid  in  Figure  35. 
The  flow  separates  at  the  expansion,  develops  clockwise  recirculation  in  the 
wake  of  the  step,  and  reattaches  to  the  wall  about  5.5  step  widths  downstream. 


66 


Chaptw  5  STREMR  E}ampl»s  and  Verification 


(BEGIN 

START- 'COLD' 

.  IREF-1  . 

FLON-'FLOBRATE’ ,  JREF-7  . 

lUNITS-' ENGLISH'  . 

TITLE- 

'EXAMPLE  IJ:  ‘0 

X  12  GRID  WITH  SQUARE  PIER  AND  BOTTOM  TRANSITION’  lEND 

(FARAH 

PUNITS-' ENGLISH 

'  .  NSTEPS-900 

. 

ALLOUT-'TES' 

.  NSTORE-900 

. 

MAPS- 'YES' 

,  NSTOMO-1 

r 

TIMER- 'YES' 

,  INFORM- 10 

• 

ITERS-3 

(END 

(INPUT 

ITEM- 'CELL  TYPES’ 

(END 

(INPUT 

ITEM-'NOSLIP’ 

11-27, 

12-32. 

Jl-4, 

J2-9  (END 

(INPUT 

ITEM- 'OUT' 

11-28. 

12-31, 

Jl-5, 

J2-8  (END 

(INPUT 

ITEM- 'FLUX' 

11-1  . 

12-1  , 

Jl-1, 

J2-12  (END 

(INPUT 

ITEM- 'OPEN' 

11-50, 

12-50, 

Jl-1, 

J2-12  (END 

(INPUT 

ITEM- 'END' 

(END 

(INPUT 

ITEM- 'GENERAL' 

(END 

(INPUT 

ITEM- 'DEPTH' 

.  VALUES-1. 

0  (END 

(INPUT 

ITEM-'X-VELOCITY’  ,  VALUES-1. 

0  (END 

(INPUT 

ITEM- 'FLOWRATE 

,  VALUES-12 

.0  (END 

(INPUT 

ITEM- ' MANNING ' 

,  VALUES-0. 

03  (END 

(INPUT 

ITEM- 'END' 

(END 

(INPUT 

ITEM- 'SECTION' 

fcEND 

(INPUT 

ITEM- 'DEPTH'  , 

11-27, 

12-32, 

Jl-4. 

J2-9  ,  values-  36*1,0  (END 

(INPUT 

ITEM- 'DEPTH'  , 

11-91. 

12-50, 

Jl-1, 

J2-12,  VALUES-120*1.0  (END 

(INPUT 

ITEM- 'END' 

(END 

(INPUT 

ITEM- ’ LINE ’ 

fcENy 

(INPUT 

ITEM- ' DEPTH '  , 

Il-l  . 

12-10, 

Jl-1 

J2-1  ,  VALUES-0. 2, 0.2 

(END 

(INPUT 

ITEM- 'DEPTH'  , 

Il-l  . 

12-10, 

Jl-12 

J2-12,  VALUES-0. 2, 0.2 

(END 

(INPUT 

ITEM- 'DEPTH'  , 

11-1  . 

12-1  , 

Jl-1 

J2-6  ,  VALUES-0. 2, 1.0 

(END 

(INPUT 

ITEM- ' DEPTH '  , 

11-10, 

12-10. 

Jl-1 

J2-6  ,  VALUES-0. 2, 1.0 

(END 

(INPUT 

ITEM- ' DEPTH '  , 

Il-l  . 

12-27, 

Jl-6 

J2-6  ,  VALUES-1. 0,1.0 

(END 

(INPUT 

ITEM- 'DEPTH'  , 

11-1  . 

12-27, 

Jl-7 

J2-7  ,  VALUES-1. 0,1.0 

(END 

(INPUT 

ITEM- 'DEPTH'  , 

11-1  . 

12-1  , 

Jl-7 

J2-12,  VALUES-1. 0,0. 2 

(END 

(INPUT 

ITEM- 'DEPTH'  , 

11-10, 

12-10, 

Jl-7 

.  J2-12,  VALOES-1.0,0.2 

(END 

(INPUT 

ITEM- 'DEPTH'  , 

11-11, 

12-41, 

Jl-1 

J2-1  .  VALUES-0. 2. 1.0 

(END 

(INPUT 

ITEM- 'DEPTH'  , 

11-11, 

12-41, 

Jl-12 

J2-12,  VALUES-0. 2,1.0 

(END 

(INPUT 

ITEM- 'END' 

(END 

(INPUT 

ITEM- 'RANDOM' 

(END 

(INPUT 

ITEM- 'END' 

(END 

Figure  30.  STREMR  input  for  50  x  12  grid  with  square  pier  and  transition  from 
V*shape  to  flat  bottom  (friction  included,  Example  1J) 


Example  2B:  Nonuniform  120  X  60  Grid  with 
Backstep 

This  example  employs  a  nonuniform  120  X  60  grid  for  the  channel 
described  in  Example  2A.  The  STREMR  input  (Figure  36)  is  similar  to 
Example  2A,  but  the  input  values  for  i  and  j  now  reflect  the  doubling  of 
IMAX  and  JMAX  .  TTie  grid  spacing  has  been  reduced  by  a  factor  of  two, 
and  the  total  number  of  time-steps  (NSTEPS)  has  been  increased  because  the 
allowable  time-step  size  is  proportional  to  the  grid  spacing. 

Like  the  previous  example,  the  grid  cells  are  perfectly  square  in  the  imme¬ 
diate  vicinity  of  the  step,  and  the  grid  spacing  gradually  increases  with  dis¬ 
tance  from  the  step.  In  this  case,  however,  the  step  width  is  divided  into 
twenty  equal  grid  spaces  (0.05  ft  each)  instead  of  ten.  The  resulting  flow  (no 
bottom  friction)  is  shown  with  the  modified  120  X  60  grid  in  Figure  37. 
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***************  jjAP  OF  CELL  TYPES  ************** 
O-OUT  1-FIELD  2-NOSLIP  3-SLIP  4-FLUX  5-OPEN 


42222222222222222222222222222222222222222222222225 

41111111111111111111111111111111111111111111111115 

41111111111111111111111111111111111111111111111115 

41111111111111111111111111222222111111111111111115 

41111111111111111111111111200002111111111111111115 

41111111111111111111111111200002111111111111111115 

41111111111111111111111111200002111111111111111115 

41111111111111111111111111200002111111111111111115 

41111111111111111111111111222222111111111111111115 

41111111111111111111111111111111111111111111111115 

41111111111111111111111111111111111111111111111115 

42222222222222222222222222222222222222222222222225 


***  MAPS  OF  RELATIVE  VALUES  OF  FLOW  VARIABLES  *** 
0  -  NO-FLOW  CELLS  (TYPE  -  OUT) 

1  -  LOWEST  VALUES  IN  NEGATIVE  SENSE 
9  -  HIGHEST  VALUES  IN  POSITIVE  SENSE 


****  DEPTH  **** 


11111111111111222333344455566667778889999999999999 

22222222222333344444555666777778888889999999999999 

44444444444445555566666777888888888^99999999999999 

66666666666666667777777888999999999999999999999999 

88888888888888888888888999900009999999999999999999 

99999999999999999999999999900009999999999999999999 

99999999999999999999999999900009999999999999999999 

88888888888888888888888999900009999999999999999999 

66666666666666667777777888999999999999999999999999 

44444444444445555566666777888888888899999999999999 

22222222222333344444555666777778888889999999999999 

11111111111111222333344455566667778889999999999999 


Figure  31 .  Ma|[»  of  cell  types  and  depths  for  50  x  12  grid  with  square  pier  and 
transition  from  V-shape  to  flat  bottom  (Example  1 J) 
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Figure  32.  Exaggerated  bathymetry  (looking  upstream)  for  straight  channel  with 
square  pier  and  transition  from  V-shape  to  flat  bottom  (Example  1 J) 

The  flow  separates  at  the  expansion,  develops  clockwise  recirculation  in  the 
wake  of  the  step  (this  time  with  a  small  zone  of  counter-clockwise  recircula¬ 
tion  at  the  base),  and  reattaches  to  the  wall  about  6.3  step  widths  downstream. 
This  amounts  to  a  IS  percent  increase  over  the  reattachment  length  predicted 
in  Example  2A.  FurUier  reflnement  of  the  grid  (by  another  factor  of  two) 
increases  the  reattachment  length  by  less  than  3  percent  To  predict  the  largest 
eddies  for  a  backstep,  it  appears  that  20  grid  ^aces  are  enough  for  discretizing 
the  step  width  (as  far  as  grid  error  is  concerned). 

Comparison  with  Test  Data  for  Backstep 

The  backstep  is  a  standard  problem  for  testing  numerical  methods  and 
turbulence  models  for  sq^arated  (recirculating)  flow.  The  reattachment  length, 
which  is  the  horizontal  distance  between  flow  separation  and  reattachment. 
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Figure  33.  Uniform  50  x  12  grid  with  computed  streamlines  and  velocity 

vectors  for  square  pier  and  transition  from  V-shape  to  flat  bottom 
(Example  1J) 


is  a  measurement  often  used  for  comparison  with  predictions.  Durst  and 
Tropea  (1981)  have  assembled  rcattachment  data  from  diverse  2-D  experiments 
(no  bottom  friction)  for  backstops,  and  these  show  that  Xj^lH  varies  with  the 
channel  expansion  ratio  H2IHJ. 

To  obtain  STREMR  predictions  for  the  variation  of  Xf^lH  with  H2IHJ  input 
for  cell  types  can  be  easily  modified  in  Examples  2A  and  2B  to  reduce  the 
channel  width  and  create  expansion  ratios  greater  than  1.1.  First,  a  .section  of 
OUT  cells  has  to  be  specified  along  the  north  side  of  the  grid.  This  OUT 
section  must  be  exactly  IMAX  cells  long,  but  its  width  depends  on  the  desired 
reduction  in  channel  width.  Next,  the  row  of  SLIP  cells  along  the  original 
north  boundary  (Figures  34  and  36)  has  to  be  moved  southward  to  lie  just 
inside  the  modified  north  boundary.  Finally,  the  end  columns  of  FLUX  and 
OPEN  cells  have  to  be  shortened  to  match  the  modified  (narrower)  grid. 
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&BEGIN  START- 'COLD' 

FLOW- 'INFLOW 
lUNITS-' ENGLISH' 
TITLE- 'EXAMPLE  2A; 
iPARAM  PUNITS-' ENGLISH' 
ALLOUT-'YES' 


.  IREF-1  . 

,  JREF-15  , 

* 

60X30  GRID  WITH  BACKSTEP' 
,  NSTEPS-2500, 

,  NSTORE-2500, 


&END 


MAPS- ' YES ' 

,  NSTOMO-1 

» 

TIMER- 'YES' 

.  INFORM-1 0 

# 

lTERS-3 

{.END 

&INPUT 

ITEM- 'CELL  TYPES' 

{.END 

StINPUT 

ITEM- 'SLIP' 

,  11*1  . 

12=60, 

Jl-30, 

J2-30 

&END 

{■INPUT 

ITEM- 'NOSLIP' 

.  Il'l  . 

12-16, 

Jl-1  , 

J2-11 

{.END 

{.INPUT 

ITEM- 'OUT' 

.  Il-l  . 

12-15, 

Jl-1  , 

J2-10 

&END 

{.INPUT 

ITEM- 'FLUX' 

.  Il-l  . 

12-1  . 

Jl-ll, 

J2-30 

&END 

{.INPUT 

ITEM- ’ OPEN ' 

.  11-60. 

12-60, 

Jl-1  , 

J2-30 

{.END 

{.INPUT 

ITEM- 'END' 

&END 

ti  INPUT 

ITEM- 'GENERAL' 

{.END 

{.INPUT 

ITEM- ' DEPTH ' 

,  VALUES-0. 

2  {.END 

S.INPUT  ITEM-'X-VELOCITY'  , 
J. INPUT  ITEM- 'MANNING' 

& INPUT  ITEM- 'END' 

&INPUT  ITEM- 'SECTION'  SEND 
MNPUT  ITEM- 'END'  &END 
5< INPUT  ITEM- 'LINE'  SEND 
S. INPUT  ITEM- 'END'  iEND 
StlNPUT  ITEM- 'RANDOM'  &END 
& INPUT  ITEM- 'END'  SEND 


VALUES=1 . 0 
VALUES-0.0 


&END 

&END 

&END 


Figure  34.  STREMR  input  for  backstep  on  nonuniform  60  x  30  grid 
(Example  2A,  no  bottom  friction;  Hg/H.,  -  1.1) 


In  Figure  38,  STREMR  predictions  for  reattacbment  length  (no  bottom  fric¬ 
tion)  are  compared  with  the  2-D  test  data  of  Durst  and  Tropea  (1981).  The 
shape  of  the  predicted  curves  is  roughly  the  same  as  that  suggested  by  the  test 
data,  which  exhibit  a  spread  of  about  15  percent.  Note  that  the  120  X  60  grid 
falls  on  the  high  side  of  the  data  with  predictions  that  are  IS  percent  greater 
than  those  of  the  60  X  30  grid.  Further  grid  refinement  (by  a  factor  of  two) 
yields  an  additional  increase  of  less  than  3  percent  in 


Parameter  Variation  for  Backstep 

The  predictions  in  Figure  38  were  all  obtained  with  the  default  value  for 
the  turbulence  parameter  (RECAP  =  2.5).  It  is  apparent  from  these  results  that 
reattachment  predictions  may  be  slightly  high  if  the  grid  is  fine  enough  to 
eliminate  most  of  the  grid  error.  The  default  value  for  RECAP  compensates 
somewhat  for  grid  error  on  coarse  grids;  but  it  is  higher  than  the  correct  value 
that  should  be  used  with  fine  grids.  Figure  39  dcmon.strates  the  effect  of 
RECAP  for  predictions  in  a  channel  with  H2/H2  =  1.1. 
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Figure  35,  Nonuniform  60  x  30  grid  wrtlr  computed  streamlines  and  velocity 
vectors  for  backstep  (Example  2 A,  no  bottom  friction;  H^/H,  =  1.1) 

With  this  arnfiguration,  STREMR  predictions  for  rcatlachmcnt  length  arc 
effectively  grid  independent  with  grids  finer  than  the  120  X  60  grid  in  Fig¬ 
ure  37.  Since  the  test  data  (Figure  38)  indicate  that  5  <  Xf^lH  <  6  for  H^!H j  = 
1.1,  one  can  infer  (Figure  39)  that  the  proper  (grid-independent)  value  for 
RECAP  lies  between  1.5  and  2.0.  N  evert  he  lc.ss,  many  STREMR  users  may  be 
reluctant  to  employ  grids  as  fine  as  the  120  X  60  grid,  and  the  default  value 
for  RECAP  has  been  set  at  2.5  U)  compens;ile  for  anticipated  grid  error.  This 
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&BEGIN  START- ’COLD'  ,  IREF-1  , 

FLOW- ' INFLOW '  ,  JREF-30  , 

IUNITS-’ ENGLISH'  , 

TITLE- ’ EXAMPLE  2B:  120X60  GRID  WITH  BACKSTEP'  &END 
&PARAM  PUNITS-' ENGLISH'  ,  NSTEPS-5000, 

ALLOUT-'YES'  ,  NSTORE-5000, 

MAPS- 'YES’  ,  NSTOMO-1 

TIMER- 'YES'  ,  INFORM-10  , 

ITERS-3  SEND 

{.INPUT  ITEM- 'CELL  TYPES'  &END 


{.INPUT 

ITEM- 'SLIP' 

.  Il-l  . 

12-120, 

Jl-60,  J2-60 

{.END 

{.INPUT 

ITEM- 'NOSLIP' 

.  Il-l  . 

12-31  , 

Jl-1  ,  J2-21 

{.END 

{.  INPUT 

ITEM- 'OUT' 

,  Il-l  . 

12-30  , 

Jl-1  ,  J2-20 

{.END 

{.INPUT 

ITEM- 'FLUX' 

.  Il-l  . 

12-1  , 

Jl-21,  J2-60 

&END 

{.INPUT 

ITEM- ' OPEN ' 

,  11-120, 

12-120, 

Jl-1  ,  J2-60 

(.END 

{.INPUT 

ITEM- 'END' 

{.END 

{.INPUT 

ITEM- ' GENERAL ' 

(.END 

{.INPUT 

ITEM- ’ DEPTH ' 

,  VALUES=0.2 

{.END 

{.INPUT 

ITEM-'X-VELOCITY’  ,  VALUES-1.0 

{.END 

&INPUT 

ITEM- 'MANNING' 

,  VALUES-0.0 

{.END 

6INPUT 

ITEM- ' END ' 

{.END 

&INPUT 

ITEM- 'SECTION' 

{.END 

{.INPUT 

ITEM- 'END' 

&END 

S. INPUT  ITEM- 'LINE'  &END 
&INPUT  ITEM- 'END'  &END 
{.INPUT  ITEM- 'RANDOM'  {.END 
{.INPUT  ITEM- 'END'  &END 


Figure  36.  STREMR  input  for  backstep  on  nonuniform  120  x  60  grid 
(Example  2B,  no  bottom  friction;  Hg/H.,  =  1.1) 

is  a  point  to  remember  whenever  fine  grids  are  used  to  achieve  accurate  flow 
predictions  and  grid  independence. 

Bottom  friction  can  also  have  a  considerable  effect  on  the  predicted  reat¬ 
tachment  length  for  a  backstep.  Figure  40  presents  STREMR  results  for 
Examples  2A  and  2B  with  Manning  coefficients  from  0.0  to  0.02.  The  highest 
value  n  =  0.02  imposes  a  bottom  friction  factor  Cr~  0.01  in  the  0.2'ft-deep 
channel,  which  reduces  x^lH  to  65  percent  of  its  frictionless  value. 


Example  3A:  Nonuniform  60  X  30  Grid  with  Spur 
Dike 

This  example  again  employs  the  nonuniform  60  X  30  grid  of  Example  2A 
for  a  channel  30  ft  long  and  0.2  ft  deep.  In  this  case,  however,  cell-type 
designations  are  used  in  the  STREMR  input  (Figure  41)  to  create  a  grid  with 
an  unsubmerged  spur  dike  (contraction/expansion)  10  ft  from  the  west  (inflow) 
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Figure  37.  Nonuniform  120  x  60  grid  with  computed  streamlines  and  velocity 
vectors  for  backsfep  (Example  28,  no  bottom  friction:  H^/H^  =1.1) 

boundary.  The  north  side  of  the  grid  (Figure  42)  is  designated  as  a  SUP 
boundary  (channel  centerline)  in  the  STREMR  input  The  resulting  grid 
widths  (channel  half  widths)  are  Hj  =  10  ft  at  the  contraction,  and  H->  =  11  ft 
upstream  and  downstream.  Thus,  the  channel  expansion  ratio  is  =  11, 

and  the  dike  length  is  H  =  H2  -  ///  =  1  ft  The  thickness  of  the  dike  is  0.2  ft 
in  the  strcamwisc  x-dircction. 
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Figure  38.  Comparison  of  STREMR  predictions  with  test  data  for  2-D  flow 
reattachment  downstream  of  backstop  (no  bottom  friction) 

Although  the  grid  is  nonuniform  far  from  the  dike,  the  grid  cells  are  per¬ 
fectly  square  in  its  immediate  vicinity.  The  dike  length  is  divided  into  ten 
equal  grid  spaces  (0.1  ft  each),  and  the  dike  thickness  is  divided  into  two  equal 
spaces  (0.1  ft  each).  The  grid  spacing  gradually  increases  with  distance  from 
the  dike  (in  both  directions).  The  resulting  flow  (no  bottom  friction)  is  shown 
with  the  modified  60  X  30  grid  in  Figure  42. 

The  flow  separates  near  the  base  of  the  upstream  side  of  the  dike,  and  at 
the  downstream  comer  of  its  north  end.  There  are  zones  of  clockwise  recircu¬ 
lation  on  both  sides  of  the  dike,  except  at  its  downstream  base,  where  there  is 
a  small  zone  of  counter-clockwise  recirculation.  The  flow  reattaches  to  the 
wall  about  15.7  dike  lengths  downstream. 
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120  X  60  Grid 
60  X  30  Grid 


1.5  2.0 

Turbulence  Parameter  RECAP 


Figure  39.  Effect  of  turbulence  parameter  RECAP  on  predicted  2-D  flow 
reattachment  for  backstop  (no  bottom  friction;  Hj/H,  =  1.1) 
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Figure  40.  Effect  of  bottom  friction  on  predicted  flow  reattachment  for  backstop 
with  Hj/H,  =  1.1  in  0.2-ft-deep  channel 
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&BEGIN 

START- 'COLD' 

,  IREF-1  , 

FLOW- 'INFLOW 

,  JREF-11  , 

lUNITS-' ENGLISH' 

« 

TITLE- 'EXAMPLE  3A: 

60X30  GRID  WITH  DIKE'  StEND 

&PARAM 

PUNITS-’ ENGLISH' 

,  NSTEPS-5000, 

ALLOUT-'YES' 

,  NSTORE-5000, 

MAPS- 'YES’ 

,  NSTOMO-1 

TIMER- 'YES’ 

,  INPORM-10  , 

ITERS-7  StEND 

i INPUT 

ITEM- 'CELL  TYPES' 

&END 

StINPUT 

ITEM- 'SLIP' 

Il-l  ,  12-60,  Jl-30, 

J2-30 

&END 

&INPUT 

ITEM- 'NOSLIP'  , 

11-14,  12-17,  Jl-1  , 

J2-11 

&END 

&INPUT 

ITEM- 'OUT' 

11-15,  12-16,  Jl-1  , 

J2-10 

StEND 

Jc  INPUT 

ITEM- 'FLUX' 

Il-l  ,  12-1  ,  Jl-1  , 

J2-30 

StEND 

& INPUT 

ITEM- 'OPEN' 

11-60,  12-60,  Jl-1  . 

J2-30 

StEND 

MNPUT 

ITEM- 'END' 

StEND 

& INPUT 

item- 'GENERAL' 

StEND 

ti  INPUT 

ITEM- 'DEPTH' 

,  VALUES-0.2  StEND 

&INPUT 

ITEM- 'X- VELOCITY 

'  ,  VALUES-1.0  SiEND 

S.INPUT 

ITEM- 'MANNING' 

,  VALUES-0.0  StEND 

& INPUT 

ITEM- 'END' 

StEND 

i INPUT 

ITEM- 'SECTION'  SiEND 

& INPUT 

ITEM- 'END'  StEND 

& INPUT 

ITEM- 'LINE'  StEND 

SilNPUT 

ITEM- 'END'  StEND 

&INPUT 

ITEM- 'RANDOM'  StEND 

StINPUT 

ITEM- 'END'  &END 

Figure  41,  STREMR  input  for  spur  dike  on  nonuniform  60  x  30  grid 
(Example  3A,  no  bottom  friction;  H2/H^  *  1.1) 


Example  3B:  Nonuniform  120  X  60  Grid  with 
Spur  Dike 

This  example  employs  the  nonuniform  120  X  60  grid  of  Example  2B  for 
the  channel  described  in  Example  3A.  The  STREMR  input  (Figure  43)  is 
similar  to  Example  3A,  but  the  input  values  for  i  and  j  now  reflect  the 
doubling  of  IMAX  and  JMAX.  The  grid  pacing  has  been  reduced  by  a  factor 
of  two,  and  the  total  number  of  time-steps  (NSTEPS)  has  been  increased 
because  the  allowable  time-step  size  is  proportional  to  the  grid  spacing. 

Like  the  previous  example,  the  grid  cells  are  perfectly  square  in  the  imme¬ 
diate  vicinity  of  the  dike,  and  the  grid  spacing  gradually  increases  with  dis¬ 
tance  from  the  dike.  In  this  case,  however,  the  dike  length  is  divided  into 
twenty  equal  grid  spaces  (0.05  ft  each)  instead  of  ten.  Likewise,  the  dike 
thickness  is  divided  into  four  equal  spaces  (C.OS  ft  each)  instead  of  two.  The 


chapter  5  STREMR  Examples  and  Verification 


77 


Figure  42.  Nonuniform  60  x  30  grid  with  computed  streamlines  and  velocity 
vectors  for  spur  dike  (Example  3A,  no  bottom  friction;  Hg/H.,  =  1.1) 

resulting  flow  (no  bottom  friction)  is  shown  with  the  modified  120  X  60  grid 
in  Figure  44. 

In  this  case,  the  flow  separates  near  the  base  of  the  upstream  side  of  the 
dike,  and  at  the  upstream  comer  of  iLs  north  end.  There  are  zones  of  clock¬ 
wise  recirculation  on  both  sides  of  the  dike,  except  at  its  downstream  base, 
where  there  is  a  .small  zone  of  counter-clockwise  recirculation.  Note  that  all 
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&BEGIN 

START- 'COLD' 

,  IREF-1  , 

FLOW- ' INFLOW ' 

.  JREF-21  . 

lUNITS-' ENGLISH' 

> 

TITLE- 'EXAMPLE  3B: 

120X60  GRID  WITH  DIKE 

&END 

&PARAM 

PUNITS-' ENGLISH' 

,  NSTEPS-15000. 

ALLOUT-'YES' 

,  NSTORE-15000, 

MAPS- 'YES' 

,  NSTOMO-1 

TIMER- 'YES' 

,  INFORM-10 

ITERS-7  &END 

&INPUT 

ITEM- 'CELL  TYPES' 

&END 

&INPUT 

ITEM- ' SLIP ' 

Il-l  ,  12-120, 

Jl-60, 

J2-60 

&END 

& INPUT 

ITEM- 'NOSLIP'  , 

11-28  ,  12-33  , 

Jl-1  , 

J2-21 

(.END 

&INPUT 

ITEM- 'OUT' 

11-29  ,  12-32  , 

Jl-1  , 

J2-20 

&END 

&INPUT 

ITEM- 'FLUX' 

Il-l  .  12-1  , 

Jl-1  , 

J2-60 

(.END 

S.  INPUT 

ITEM- 'OPEN' 

11-120,  12-120, 

Jl-1  , 

J2-60 

(.END 

ScINPUT 

ITEM- ' END ' 

&END 

& INPUT 

ITEM- 'GENERAL' 

(.END 

&INPUT 

ITEM- 'DEPTH' 

,  VALUES-0.2 

&END 

&INPUT 

ITEM-'X-VELOCITY 

'  ,  VALUES-1,0 

&END 

& INPUT 

ITEM- 'MANNING' 

,  VALUES- 0.0 

&END 

& INPUT 

ITEM- ’ END ’ 

(.END 

& INPUT 

ITEM- 'SECTION'  6END 

StINPUT 

ITEM- 'END'  StEND 

& INPUT 

ITEM- -LINE'  &END 

&1NPUT 

ITEM- 'END'  SEND 

& INPUT 

ITEM- 'RANDOM'  &END 

8.INPUT 

ITEM- 'END'  S.END 

Figure  43.  STREMR  input  for  spur  dike  on  nonuniform  120  x  60  grid 
(Example  3B,  no  bottom  friction;  Hg/H^  =  1.1) 

the  recirculation  zones  for  the  120  X  60  grid  are  larger  than  those  for  the  60  X 
30  grid. 

The  flow  reattaches  to  the  wall  about  18  dike  lengths  downstream,  and  this 
amounts  to  a  IS  percent  increase  over  the  reattachment  length  predicted  in 
Example  3A.  Further  refinement  of  the  grid  (by  another  factor  of  two)  in¬ 
creases  the  reattachment  length  by  less  than  3  percent.  To  predict  the  largest 
eddies  for  a  spur  dike,  it  appears  that  20  grid  spaces  are  enough  for  discretiz¬ 
ing  the  dike  length  (as  far  as  grid  error  is  concerned). 

TTie  dike  r^resents  a  more  difficult  problem  than  the  backstep,  because  the 
dike  is  more  sensitive  to  flow  conditions  immediately  upstream.  In  particular, 
the  flow  on  the  upstream  side  determines  the  angle  of  flow  separation  at  the 
end  of  the  dike,  which  influences  the  reattachment  length  downstream.  As 
a  result,  the  computed  flow  may  change  considerably  with  the  distance  of  the 
dike  from  the  inflow  boundary.  In  Examples  3A  and  3B,  however,  the  dike 
has  been  placed  far  enough  from  the  channel  entrance  that  further  (down¬ 
stream)  changes  in  position  have  no  effect  on  the  computed  flow. 
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Figure  44,  Nonuniform  120  y  60  grid  with  computed  streamlines  and  velocity 
vectors  for  spur  dike  (Example  3B,  no  bottom  friction;  H^/H^  =  11) 


Test  Data  for  Dikes 


Unfortunately,  there  seem  to  be  fewer  experimental  data  available  for  dikes 
than  for  backsteps.  For  a  dike  with  (streamwise)  thickness  2H,  Moss  and 
Baker  (1980)  report  Xj^lH  -  12  in  a  wind  tunnel  with  i  =  11.  For  thin 
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dikes,  Rajaratnum  and  Nwachukwu  (1983)  report  Xj^jH  <•  12  in  smooth, 
shallow  channels  (0.5  to  0.84  ft  deep)  with  H2IHJ  =  1.09  to  1.2;  however, 
Francis,  Pattanick,  and  Weame  (1968)  report  «•  13  in  smooth,  shallow 
channels  (0.21  ft  deep)  with  H2IH ^  =  1.15  to  1.21.  These  data  are  too  few  to 
indicate  the  general  variation  of  reattachment  length  with  channel  expansion 
ratio,  but  they  do  suggest  an  approximate  range  for  the  correct  value  of  Xj^lH 
in  Examples  3A  and  3B. 


Parameter  Variation  for  Spur  Dike 

Figure  45  offers  STREMR  predictions  (without  verification)  for  the  varia¬ 
tion  of  Xj^m  with  H2IHJ  (no  bottom  friction).  These  results  were  obtained  by 
modifying  the  cell-type  input  in  Examples  3A  and  3B  to  reduce  the  channel 
width  and  create  expansion  ratios  greater  than  1.1.  Note  that  Xj^lH  now 
decreases  with  increasing  H2IH 7.  As  the  channel  expansion  ratio  increases, 
the  channel  becomes  narrower  at  the  constriction  imposed  by  the  dike.  This 
increased  confinement  reduces  the  angle  of  flow  separation  at  the  end  of  the 
dike,  which  shortens  the  reattachment  length  downstream. 

The  predictions  in  Figure  45  were  all  obtained  with  the  default  value  for 
the  turbulence  parameter  (RECAP  =  2.5).  Uncertainty  in  the  bottom  friction, 
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Figure  45.  STREMR  predictions  for  2-D  flow  reattachment  downstream  of  spur 
dike  (no  bottom  friction) 
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however,  compounds  the  difficulty  of  inferring  the  best  value  for  RECAP  from 
the  scant  experimental  data  cited  above. 

Figure  46  demonstrates  the  effect  of  RECAP  on  reattachment  predictions 
made  for  H2/H1  =  1.1  with  no  bottom  friction  (n  =  0.0).  Here  the  120  X  60 
grid  predicts  Xg/H  =  11.5  for  RECAP  =  1.0,  Xj^lH  =  14.5  for  RECAP  =  1.5, 
and  Xj^/H  =  17.3  for  RECAP  =  2.0. 


Turbulence  Parameter  RECAP 


Figure  46.  Effect  of  turbulence  parameter  RECAP  on  predicted  2-D  flow 
reattachment  for  spur  dike  (no  bottom  friction;  Hg/H,  =1.1) 


Figure  47  presents  reattachment  predictions  made  for  =1.1  and 

RECAP  =  2.5  with  Manning  coefficients  from  0.0  to  0.02.  The  highest 
Manning  coefficient  n  =  0.02  imposes  a  bottom  friction  factor  Cy  =  0.01  in  the 
0.2-ft-deep  channel,  for  which  the  120  X  60  grid  predicts  Xf^lH  =  12.5. 

From  Figures  46  and  47  together,  one  can  infer  that  the  120  X  60  grid 
would  predict  Xj^lH  »  11.7  with  n  =  0.01  and  RECAP  =  2.0,  and  likewise  Xj^lH 
-«  10.0  with  n  =  0.01  and  RECAP  =  1.5.  Assuming  that  Manning’s  coefficient 
was  somewhere  between  0.0  and  0.01  in  the  cited  experiments,  the  proper 
(grid-independent)  value  for  RECAP  then  lies  between  1.5  and  2.0.  As  slated 
earlier,  however,  many  STREMR  users  may  be  reluctant  to  employ  grids  as 
fine  as  the  120  X  60  grid,  and  the  default  value  for  RECAP  has  been  set  at  2.5 
to  compensate  for  anticipated  grid  error. 
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Manning  Coefficient  n 


Figure  47.  Effect  of  bottom  friction  on  predicted  flow  reattachment  for  spur  dike 
with  H2/H,  =1.1  in  0.2-ft-deep  channel 


Example  4:  83  X  25  Curvilinear  Grid  with  2-D  Hill 

In  all  the  previous  examples  involving  separated  flow,  the  point  of  separa¬ 
tion  was  invariably  a  sharp  comer.  It  is  a  lucky  accident,  however,  that  real 
flows  and  computed  flows  both  separate  at  sharp  comers  with  adverse  pressure 
gradients  (exc^t  at  very  low  Reynolds  numbers).  Real  flows  separate  for 
physical  reasons,  but  computed  flows  may  separate  (or  fail  to  separate)  for 
reasons  that  are  partly  nonphysical  (Examples  IB*  11^.  With  adverse  pressure 
gradients,  however,  flow  separation  at  a  comer  can  occur  even  for  SLIP 
boundaries,  where  there  is  supposed  to  be  no  tangential  shear  stress. 

To  predict  flow  separation  on  curved  walls  without  sharp  comers,  numerical 
models  must  adequately  approximate  the  gradient  of  pressure  and  the  diver¬ 
gence  (imbalance)  of  shear  stress  near  the  wall.  The  pressure  poses  no  great 
problem,  because  it  changes  gradually  with  distance  from  the  wall,  and  it  is 
well  approximated  by  STREMR  calculations  using  fairly  coarse  grids.  The 
shear  stress,  on  the  other  hand,  requires  much  finer  grids  that  can  better 
resolve  the  velocity  and  turbulence  close  to  the  wall. 

To  demonstrate  the  trial-and-error  process  of  generating  suitable  grids  for 
curved  boundaries,  the  next  set  of  STREMR  calculations  shows  the  effect  of 
grid  refinement  on  flow  predictions  for  a  gentle  2-D  hill  in  elevation  view. 
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The  hill  profile  can  also  be  regarded  as  a  2-D  channel  indentation  in  plan 
view,  but  the  results  are  the  same  either  way.  There  is  no  bottom  friction,  and 
the  depth  is  arbitrary  normal  to  the  plane  of  flow. 

Figure  48  shows  the  STREMR  input  for  an  83  X  25  grid  with  arbitrary 
(default)  depth.  The  grid  (Figures  49-52)  is  4.01  meters  tong,  and  2,0  meters 
high  at  the  east  and  west  ends.  The  hill  has  a  maximum  height  H  of 
0.208  meter,  and  it  is  centered  1.63  meters  from  the  west  (inflow)  boundary. 
The  surface  of  the  hill  is  a  circular  arc  of  radius  1.08  meters,  which  is  rounded 
off  at  its  leading  and  trailing  edges  by  arcs  of  radius  0.4  meter. 

In  Figures  49-52,  the  vertical  grid  spacing  Ay  at  the  lower  boundary  is 
reduced  by  successive  factors  of  two.  This  is  accomplished  simply  by  shifting 
gridlines  toward  the  lower  boundary,  without  changing  the  total  number  of  grid 
spaces  in  the  vertical.  The  STREMR  input  (Figure  48)  is  the  same  for  each  of 
these  grids. 


&BEGIN  START='C0LD' 

FL0W= ’ INFLOW  , 
1UNITS=' METRIC'  , 
TITLE= ' EXAMPLE  4 
&PARAM  PUNITS»’ METRIC  , 
ALLOUT” ' NO ' 
MAPS=’YES' 
TIMER* ’YES’ 


St  INPUT  ITEM* 'CELL  TYPES' 
&INPUT  ITEM* 'SLIP'  .  11*1 
SiINPUT  ITEM- 'FLUX'  Il-l 
StlNPUT  ITEM* 'OPEN'  ,  11*83 
JtINPUT  ITEM* 'END' 

& INPUT  ITEM* 'GENERAL' 
&INPUT  ITEM*'X-VEL0CITY'  , 
&INPUT  ITEM- 'END' 

&INPUT  ITEM- 'SECTION'  &END 
&  INPUT  ITEM- 'END'  S.END 
&INPUT  ITEM- 'LINE'  &END 
StlNPUT  ITEM* 'END'  &END 
SiINPUT  ITEM*  ' RANDOM ’  SEND 
SiINPUT  ITEM* 'END'  fcFNn 


1REF*1  , 

JREF-15, 

83  X  25  GRID  WITH  HILL'  S.END 
NSTEPS-1500, 

NSTORE-1500, 

NST0M0=1  .  , 

INFORM* 10  , 

lTERS-3 
IPMIN-1 
IPMAX-83  , 

JPMIN*1 
JPMAX-10  , 

1SKIP=1 

JSKIP*1  &END 

SiEND 

12=83,  Jl=25,  J2-25  tlEND 
12-1  ,  Jl-1  ,  J2-25  StEND 
12*83,  Jl*l  ,  J2-25  SiEND 

StEND 

SiEND 

VALUES-20.  StEND 
StEND 


Figure  48.  STREMR  input  for  curvilinear  83  x  25  grid  with  2-D  hill  (Example  4) 


84 


Chapter  5  STREMR  Examples  and  Verification 


AD>A269  949  STREHR:  HUNERICAL  MODEL  FOR  DEPTH-AUERAOED 

INCOMPRESSIBLE  FLOU<U>  ARMY  ENGINEER  UATERUAYS 
n  EXPERIMENT  STATION  OICKSBURG  MS  HYDRAULICS  LAB 
{UNCLASSIFIED  R  BERNARD  SEP  93  UES/TR/HL-REMR-HY-ll 


Figure  50.  Medium  83  x  25  grid  (Ay/H  =  0.096  along  hillside)  with  computed 
streamlines  and  velocity  vectors  tor  2-D  hill 
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Figure  52.  Ultrafine  83  x  25  grid  (Ay/H  =  0.024  along  hillside)  with  computed 
streamlines  and  velocity  vectors  for  2-D  hill 
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With  Ay///  =  0.192,  the  coarse  grid  (Figure  49)  approximates  the  shear 
stress  so  poorly  that  it  produces  no  flow  separation  at  all.  With  Ay///  =  0.096, 
the  medium  grid  (Figure  50)  yields  a  small  recirculation  zone;  but  this  grid  is 
still  too  coarse,  and  separation  occurs  too  far  downstream  for  even  a  qualitative 
simulation  of  a  real  flow.  With  Ay/H  =  0.048  ,  the  fine  grid  (Figure  51) 
results  in  a  longer  recirculation  zone;  but  this  grid  is  not  quite  fine  enough  to 
achieve  grid  independence. 

With  Ay///  =  0.024,  the  ultrafine  grid  (Figure  52)  produces  flow  separation 
2.077  meters  from  the  inflow  (measured  horizontally),  followed  by  reattach¬ 
ment  at  2.663  meters.  Thus,  the  predicted  reattachment  length  is  0.586 
meters,  and  x^lH  is  2.82.  Further  reduction  of  Ay  (by  another  factor  of  two) 
increases  x^///  by  less  than  1  percent.  On  the  other  hand,  reduction  of  the 
average  horizontal  spacing  Ax///  by  a  factor  of  two  (from  0.232  to  0.116) 
increases  x^///  by  10  percent,  with  negligible  increase  thereafter.  From  this  it 
appears  that  the  reattachment  predictions  become  effectively  grid  independent 
when  Ax///  =  0.116  and  Ay///  =  0.024  . 


Comparison  with  Test  Data  for  2-D  Hill 

Baskaran,  Smits,  and  Joubert  (1987)  have  studied  the  2-D  hill  in  wind- 
tunnel  experiments,  for  which  the  Reynolds  number  was  277,000  based  on  the 
inflow  velocity,  the  height  of  the  hill,  and  the  molecular  viscosity.  In  these 
experiments,  a  trip  wire  was  placed  0.153  meter  (measured  horizontally)  from 
the  inflow  to  induce  transition  to  turbulence.  Separation  occurred  at 
2.095  meters,  followed  by  reattachment  at  2.720  meters.  Thus,  the  observed 
reattachment  length  x^  was  0.625  meter,  and  x^///  was  3.00.  Figure  53  com¬ 
pares  this  datum  to  a  plot  of  STREMR  predictions  made  with  Ax///  =  0.232 
and  variable  Ay///. 

Note  that  the  STREMR  input  (Figure  48)  sets  ALLOUT  =  ’NO’,  with  non¬ 
zero  values  for  the  print  indices  (IPMIN,  IPMAX,  JPMIN,  and  JPMAX)  in 
namelist  PARAM.  This  produces  a  cell-by-cell  listing  of  the  flow  variables  for 
the  specified  range  of  i  and  j,  followed  by  a  similar  listing  of  Cr  and  for 
the  included  SLIP  and  NOSLIP  cell  faces.  The  latter  two  quantitites  are  the 
sidewall  friction  coefficient  and  pressure  coefficient,  respectively,  defined  by 
Equations  2  and  3  in  Part  IV. 

Figure  54  compares  the  wind-tunnel  test  data  for  Cy  and  C-  against 
STREMR  predictions  made  with  the  ultrafine  grid  (Figure  52).  The  values  in 
Figure  54  were  computed  from  the  shear  stress  and  the  pressure  on  the  lower 
boundary.  For  reference,  the  hill  profile  is  drawn  to  scale  at  the  top  of  the 
figure,  and  the  distance  along  the  abscissa  is  the  corresponding  horizontal 
position. 

The  predicted  Cy  is  high  near  the  entrance  because  of  the  high  shear  stresis 
imposed  by  the  fixed  velocity  at  the  inflow  (FLUX)  boundary.  Downstream, 
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Nondimensional  Grid  Spacing  Ay/H 


Figure  53.  Effect  of  vertical  grid  spacing  A  along  hillside  on  predicted  flow 
reattachment  for  2-D  hill 

the  friction  coefficient  falls  as  the  velocity  near  the  lower  boundary  falls, 
reaching  a  minimum  at  the  leading  edge  of  the  hill.  It  then  climbs  until  it 
reaches  a  peak  halfway  up  the  hill,  from  which  it  falls  until  the  point  of  flow 
separation  (Cy=  0)  atjc  =  2.077  meters. 


Parameter  Variation  for  2-D  Hiii 

At  worst,  the  predicted  values  for  C^are  in  error  by  a  factor  of  two. 
Reduction  of  TURBIN  from  0.003  (default)  to  0.001  in  namelist  BEGIN 
reduces  the  peak  value  of  Cj-  by  20  percent,  and  it  increases  Xj^lH  by 
10  percent.  Reduction  of  Ay/ff  from  0.024  to  0.0024  reduces  the  peak  Cy  by  a 
factor  of  two,  flattens  the  curve  for  Cy  near  the  entrance,  and  increases  Xj^lH  by 
less  than  1  percent.  Further  reduction  of  Ay///  flattens  the  predicted  curve  for 
Cy  in  general,  and  agreement  with  the  measured  Cy  deteriorates  thereafter. 
Apparently  the  empirical  procedure  for  calculating  turbulent  shear  stress  is  not 
applicable  very  close  to  the  wall  (i.e.,  inside  a  boundary  layer).  Fortunately, 
however,  the  predictions  for  Xj^lH  are  not  affected  by  the  deterioration  of  Cy. 
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Figure  54.  Comparison  of  STREMR  2-D  hill  predictions  (uttrafine  83  x  25  grid) 
with  test  data  for  friction  and  pressure  coefficients  akwig  hillside 
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Agreement  between  the  measured  and  predicted  values  of  is  fairly  good, 
except  that  the  predicted  minimum  is  off  by  about  20  percent.  Neither  refine¬ 
ment  of  the  grid  nor  adjustment  of  the  empirical  STREMR  parameters  has  any 
significant  effect  on  this  discrepancy. 

All  the  STREMR  predictions  for  the  2-D  hili  (Figures  49-54)  were  made 
with  RECAP  =  2.5.  With  this  (default)  value,  the  ultrafine  grid  (Figure  52) 
yields  XjffH  =  2.82,  which  is  6  percent  less  than  the  observed  value.  With 
RECAP  =  2.0,  the  same  grid  gives  Xj^lH  -  2.51  (16  percent  low);  and  with 
RECAP  =  1.5,  it  gives  Xf^lH  =  2.21  (26  percent  low).  Assuming  that  these 
results  include  a  20  percent  underprediction  from  the  combined  effects  of  grid 
enor  and  uncertainty  in  TURBIN,  it  appears  (once  again)  that  the  proper  (grid- 
independent)  value  for  RECAP  lies  between  1.5  to  2.0. 


Example  5A:  Curvilinear  40  X  34  Grid  with  2-D 
Circular  Cylinder 

Figure  55  shows  a  curvilinear  40  X  34  grid  as  it  appears  in  the  Cartesian 
(x,y)  and  computational  (ij)  planes.  This  grid  represents  a  2-D  channel,  10  ft 
long  and  6  ft  wide  in  plan  view,  which  contains  a  2-ft-diametcr  cylinder  cen¬ 
tered  3  ft  from  the  west  (inflow)  boundary.  The  cylinder  is  circular  in  the 
Cartesian  plane,  but  it  is  square  in  the  computational  plane,  with  10  grid 
spaces  on  each  of  its  four  sides.  There  is  no  bottom  friction,  and  the  depth  is 
arbitrary  normal  to  the  plane  of  flow. 

Figure  56  shows  the  STREMR  input  for  the  40  X  34  grid.  Since  this  flow 
configuration  should  develop  an  unsteady  wake  (vortex  street),  the  input  sets 
TIMER  =  ’NO’  and  specifies  a  fixed  time-step  DTIME  =  0.02.  The  fixed 
time-step  allows  direct  comparison  of  time-dependent  results  for  this  grid  with 
those  for  other  grids. 

Figure  57  shows  the  40  X  34  grid  and  the  computed  flow  after  2500  time- 
steps  (50  seconds).  Although  the  flow  does  separate  on  the  lee  side  of  the 
cylinder,  this  occurs  too  far  aft  for  vortex  shedding  to  occur,  and  the  predicted 
wake  is  only  slightly  unsteady  and  slightly  asymmetric.  In  this  case,  the  grid 
is  too  coarse  to  predict  even  the  approximate  location  of  the  separation  points, 
and  the  resulting  flow  is  qualitatively  incorrect  Refinement  of  the  grid,  how¬ 
ever,  changes  the  predictions  considerably. 


Example  5B:  Curvilinear  80  X  60  Grid  with  2-D 
Circular  Cylinder 

Figure  58  shows  the  STREMR  input  for  the  same  channel  (Example  5A) 
with  an  80  X  60  grid.  As  before,  the  cylinder  is  circular  in  the  Cartesian 
plane,  but  it  is  now  divided  into  20  grid  spaces  per  side  in  the  computational 
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a.  Cartesian  (x,y)  plane 
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b.  Computational  (i,j)  plane 
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&INPUT 
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&INPUT 
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{(INPUT 
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{(INPUT 
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ITEM- 'RANDOM'  SEND 

{(INPUT 

ITEM- 'END'  {(END 

Figure  56.  STREMR  input  for  curvilinear  40  x  34  grid  with  2*D  circular  cylinder  ! 

(no  bottom  friction,  Example  5A)  j 

1 


plane.  Figure  59  shows  the  8U  X  60  grid  and  the  predicted  flow  after  2500 
time-steps  (50  seconds). 


TThe  computed  flow  shown  in  Figure  59  is  radically  different  from  that  in 
Figure  57.  With  the  80  X  60  grid,  separation  occurs  much  further  forward 
than  with  the  40  X  34  grid.  This  allows  an  unsteady  wake  to  develop  sponta¬ 
neously  behind  the  cylinder,  with  vortices  being  shed  from  opposite  sides  of 
the  cylinder  at  regular  time- intervals.  Further  refinement  of  the  grid  has  little 
effect  on  the  gross  features  of  the  vortex  street 


Example  5C:  Curvilinear  120  X  90  Grid  with  2-D 
Circular  Cylinder 

Figure  60  shows  the  STREMR  input  for  the  same  channel  (Examples  5A 
and  5B)  with  a  120  X  90  grid.  As  before,  the  cylinder  is  circular  in  the 
Cartesian  plane,  but  it  is  now  divided  into  30  grid  spaces  per  side  in  the  com¬ 
putational  plane.  Figure  61  shows  the  120  X  90  grid  and  the  predicted  flow 
after  2500  time-steps  (50  seconds). 

There  is  little  difference  between  the  streamlines  in  Figure  59  and  those  in 
Figure  61.  The  two  wakes  are  slightly  out  of  phase  with  each  other,  but  this  is 
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Figure  57.  Curvilinear  40  x  34  grid  with  computed  streamlines 
and  velodty  vectors  for  2-D  circular  cylinder 
(Example  5A,  time-step  2500) 
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ITEM- 'END'  StEND 

ITEM- 'RANDOM'  StEND 
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Figure  58.  STREMR  input  for  curvilinear  80  x  60  r  id  with  2-D  circular  cylinder 
(no  bottom  friction.  Example  5B) 


not  surprising  in  view  of  the  large  number  of  elapsed  time-steps.  As  far  as 
simulating  the  gross  flow  behavior  is  concerned,  there  is  little  reason  to  use  the 
120  X  90  grid  instead  of  the  80  X  60  grid.  Both  grids  yield  essentially  the 
same  information  downstream  of  the  cylinder. 


Physical  Specifications  for  Doubie  Bendway 

The  final  set  of  examples  concerns  an  S-shaped  flume  called  the  Channel 
Bend  Facility,  which  has  been  investigated  in  experiments  conducted  by 
Maynord.^  This  channel  has  a  trapezoidal  cross  section  and  consists  of  two 
100-deg  bends  with  a  reversal  in  curvature.  The  pertinent  linear  dimensions 
are  given  in  feet  in  the  Figure  62,  which  shows  the  wetted  cross  section  and 
the  water  surface  (as  represented  by  a  121  X  24  grid).  Computed  results  for 
this  channel  demonstrate  the  influence  of  grid  refinement  and  slope  discretiza¬ 
tion  on  the  STREMR  velocity  predictions. 

Figure  63  shows  the  actual  side  slope  along  with  its  stair-stepped  discretiza¬ 
tion  for  each  of  three  different  grids.  The  discrete  depth  for  each  grid  cell  is 


^  Unpublished  test  data  and  channel  specifications  provided  by  S.  T.  Maynord,  Research 
Hydraulic  Engineer,  August  1987,  US  Army  Engineer  Waterways  Experiment  Station, 
Vicksburg,  MS. 
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Figure  60.  STREMR  input  for  curvilinear  120  x  90  grid  with  2-D  circular 
cylinder  (no  bottom  friction,  Example  5C) 


the  true  depth  measured  at  the  center  of  the  cell.  The  Manning  coefficient  is 
uniformly  0.02,  which  gives  a  bottom  friction  cocfficier'  af  0.00754  at  the 
maximum  channel  depth  of  0.455  ft. 

The  actual  flowrate  in  the  experiments  was  6.75  cfs,  but  the  STREMR 
calculations  impose  a  flowrate  of  3.55  cfs.  This  does  not  change  the  physics 
of  the  flow  as  far  as  STREMR  is  concerned,  but  it  does  make  the  average 
velocity  unity  for  any  cross  section.  The  computed  velocities  then  represent 
normalized  velocities  (depth-averaged  velocity  divided  by  section-averaged 
velocity)  which  are  convenient  for  comparison  with  Maynord’s  test  data.  This 
particular  normalization  suppresses  errors  in  the  average  velocity  magnitude, 
but  it  spotlights  errors  in  the  local  velocity  distribution. 


Example  6A:  Curvilinear  121  X  14  Grid  with 
Double  Bendway 

Figure  64  displays  the  STREMR  input  for  a  curvilinear  121  X  14  grid, 
which  is  shown  with  the  predicted  streamlines  and  velocity  vectors  in  Fig¬ 
ure  65.  On  the  side  slopes  of  the  channel,  the  grid  has  a  uniform  lateral  spac¬ 
ing  of  0.4  ft.  Beyond  the  toe  of  the  slope,  however,  this  spacing  gradually 
increa.ses  with  distance  from  the  toe. 
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Figure  62.  Channel  cross  section  and  grid  (water  surface)  plan  view  for  double 
bendway  (Examples  6A-6C) 


The  streamlines  indicate  very  little  about  the  flow  development,  but  the 
velocity  vectors  make  it  easy  to  trace  the  gradual  migration  of  high  velocity 
toward  the  outside  of  each  bend.  This  behavior  is  typical  for  natural  and  arti¬ 
ficial  channels  in  which  the  ratio  of  depth  to  radius  of  curvature  is  small. 

Example  6B:  Curvilinear  121  X  24  Grid  with 
Double  Bendway 

Figure  66  displays  the  STREMR  input  for  a  curvilinear  121  X  24  grid, 
which  is  shown  with  predicted  streamlines  and  velocity  vectors  in  Figure  67. 
On  the  side  slopes  of  the  channel,  the  grid  has  a  uniform  lateral  spacing  of 
0.2  ft  Beyond  the  toe  of  the  slope,  this  spacing  gradually  increases  with 
distance  from  the  toe. 
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Figure  63.  STREMR  discretization  of  channel  side  slope  for  double  bendvyay 
with  successively  refined  grids  (Examples  6A-6C) 

Like  those  for  Example  6A,  the  streamlines  in  Figure  67  indicate  very  little 
about  the  flow  development,  but  the  velocity  vectors  again  make  it  easy  to 
trace  the  gradual  migration  of  high  velocity  toward  the  outside  of  each  bend. 
Exc^t  for  a  greater  density  of  plotted  vectors  in  Figure  67,  it  is  difficult  to 
discern  any  difference  in  results  obtained  with  the  121  X  14  grid  and  the  121 
X  24  grid. 
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Figure  64.  STREMR  input  for  curvilinear  121  x  14  grid  with  double  bendway 
(bottom  friction  included,  Example  6A) 


Example  6C:  Curvilinear  121  X  48  Grid  with 
Double  Bendway 

Figure  68  displays  the  STREMR  input  for  a  curvilinear  121  X  48  grid, 
which  is  sho'wn  with  predicted  streamlines  and  velocity  vectors  in  Figure  69. 
On  the  side  slopes  of  the  channel,  the  grid  has  a  uniform  lateral  spacing  of 
0.1  ft  Beyond  the  toe  of  the  slope,  this  spacing  gradually  increases  with 
distance  from  the  toe. 

Like  those  for  Examples  6A  and  6B,  the  streamlines  in  Figure  69  indicate 
very  little  about  the  flow  development,  but  the  velocity  vectors  still  make  it 
easy  to  trace  the  gradual  migration  of  high  velocity  toward  the  outside  of  each 
bend.  Except  for  an  even  greater  density  of  plotted  vectors  in  Figure  69,  it  is 
difficult  to  discern  any  difference  in  r^ults  obtained  with  the  121  X  14  grid, 
the  121  X  24  grid,  and  the  121  X  48  grid. 
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Figure  65.  Curvilinear  121  x  14  grid  with  computed  streamlines  and  velocity 
vectors  for  double  bendway  (Example  6A) 

Comparison  with  Test  Data  for  Double  Bend  way 

Figures  70-73  compare  normalized  STREMR  velocity  predictions  with 
normalized  test  data  at  four  different  stations  in  the  channel.  Each  figure 
includes  a  plan  view  of  the  channel  with  an  arrow  showing  the  position  and 
orientation  of  the  observer.  Normalized  lateral  position  is  the  distance  from 
the  water’s  edge  (indicated  by  the  arrow),  divided  by  the  width  of  the  water 
surface.  The  predictions  reproduce  the  observed  distributions  within  7  percent 
for  Stations  2-4  (Figures  71-73),  Errors  of  15  percent  are  evident  for 
Station  1,  however,  near  the  toe  of  the  inner  slope  (Figure  70). 
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Figure  66.  STREMR  input  for  curvilinear  121  x  24  grid  with  double  bendway 
(bottom  friction  included,  Example  6B) 


It  is  puzzling  that  the  worst  errors  occur  in  the  short  straight  reach  upstream 
of  the  first  bend.  Moreover,  they  occur  on  or  near  the  side  slopes,  and  they 
seem  not  to  be  related  to  channel  curvature.  Errors  of  the  same  kind  and  mag¬ 
nitude  are  typical  even  for  long  straight  reaches  with  sloped  sides  (Bernard  and 
Schneider  1992).  They  may  come  from  the  relatively  simple  approximation 
used  for  bottom  friction  (/^pendix  A),  which  depends  on  depth  but  not  slope. 


From  a  practical  standpoint,  grid  refinement  has  little  effect  on  the  predic¬ 
tions  shown  in  Figures  70-73.  Computed  results  for  the  121  X  24  grid  and  the 
121  X  48  grid  are  almost  indistinguishable.  These  two  grids  resolve  the  maxi¬ 
mum  velocity  better  than  the  121  X  14  grid,  but  the  slight  improvement  hardly 
justifi^  the  additional  computer  time  needed  for  the  STREMR  calculations 
with  the  finer  grids. 

This  points  up  another  reason  for  trying  different  grids  at  the  beginning  of  a 
modeling  effort.  Hie  grid  should  be  no  finer  than  is  actually  needed  for  the 
application  at  hand.  Over-refinement  of  the  grid  may  yield  no  useful  infor¬ 
mation,  but  it  al'ways  increases  the  execution  time  for  STREMR. 
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& BEGIN 

START- ' COLD ‘ 

.  IREF-1  , 

FLOW- ’ FLOWRATE • 

,  JREF-24  , 

lUNITS-' ENGLISH' 

» 

TITLE- ' EXAMPLE  6C 

:  121  X  48  GRID  WITH  DOUBLE  BENDWAY'  (END 

(PARAM 

PUNITS-' ENGLISH'  , 

NSTEPS-2500, 

ALLOUT- ' YES ' 

NSTORE-2500, 

MAPS- 'YES' 

NSTOMO-1 

TIMER- 'YES' 

INFORM-10  , 

ITERS-3  (END 

S  INPUT 

ITEM- 'CELL  TYPES' 

(END 

UNPUT 

ITEM- 'FLUX'  , 

Il-l 

,  12-1  .  Jl-l,  J2-48  (END 

{.INPUT 

ITEM- 'OPEN'  , 

11-121.  12-121,  Jl-l,  J2-48  (END 

{.INPUT 

ITEM- ’END' 

(END 

&INPUT 

ITEM- ' GENERAL ' 

(END 

(INPUT 

ITEM- ' FLOWRATE ' 

.  VALUES-3 . 55  (END 

(INPUT 

ITEM- 'DEPTH' 

,  VALUES-0.4SS  (END 

(INPUT 

ITEM- 'MANNING' 

,  VALUES-0.020  (END 

(INPUT 

ITEM-'I-VELOCITY' 

,  VALUES-1 . 0  (END 

(INPUT 

ITEM- 'END' 

(END 

(INPUT 

ITEM- 'SECTION' 

(END 

(INPUT 

ITEM- 'DEPTH'  . 

11- 

1.  12-121,  Jl-9,  J2-40,  VALUES-3872*0.455  (END 

(INPUT 

ITEM- 'END' 

(END 

(INPUT 

ITEM- 'LINE' 

(END 

(INPUT 

ITEM- 'DEPTH'  , 

11- 

1  .  12-121,  Jl-l  ,  J2-1  ,  VALUES-0. 028, 0.028 

(END 

(INPUT 

ITEM- 'DEPTH'  , 

11- 

1  ,  12-121,  Jl-48.  J2-48,  VALUES-0 . 028 , 0 . 028 

(END 

(INPUT 

ITEM- 'DEPTH'  , 

11- 

1  ,  12-1  .  Jl-l  ,  J2-8  ,  VALUES-0. 028, 0.426 

(END 

(INPUT 

ITEM- ' DEPTH '  , 

11- 

121,  12-121,  Jl-l  ,  J2-8  ,  VALUES-0. 028, 0.426 

(END 

(INPUT 

ITEM- 'DEPTH'  , 

11- 

1  ,  12-1  .  Jl-41,  J2-48,  VALUES-0. 426, 0.028 

(END 

(INPUT 

ITEM- 'DEPTH'  , 

11- 

121,  12-121,  Jl-41,  J2-48.  VALUES-0 . 426 . 0 . 028 

(END 

(INPUT 

ITEM- 'END' 

(END 

(INPUT 

ITEM- ' RANDOM ' 

(END 

(INPUT 

ITEM- 'END' 

(END 

Figure  68.  STREMR  input  lor  curvilinear  121  x  48  grid  with  double  bendway 
(bottom  friction  included,  Example  6C) 
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Figure  70.  Comparison  of  STREMR  predictions  with  test  data  for  Figure  71.  Comparison  of  STREMR  predictions  with  test  data  for 
station  1  of  double  bendway  (arrow  shows  position  station  2  of  double  bendway  (arrow  shows  position 

and  orientation  of  observer)  and  orientation  of  observer) 
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6  Conclusion 


The  STREMR  code  is  now  ready  for  routine  implementation  by  field  engi¬ 
neers  and  others  with  an  interest  in  depth-averaged  flow  modeling.  It  can  be 
executed  by  almost  anyone  with  access  to  a  suitable  computer,  but  the  inter¬ 
pretation  of  its  output  requires  some  understanding  of  fluid  mechanics.  The 
deeper  the  understanding,  the  better  the  physical  interpretation  will  be. 

Concerning  misinterpretation,  perhaps  the  greatest  danger  is  that  some  users 
may  accept  first-cut  predictions  at  face  value,  with  no  attempt  at  grid  refine¬ 
ment  Grid  refinement  may  not  actually  be  necessary,  but  the  only  way  to  fi.nd 
out  is  to  try  two  or  more  grids  for  liic  same  flow  configuration. 

In  any  case,  to  resolve  separated  (recirculating)  flow,  smooth  boundaries 
require  finer  local  grid  spacing  than  do  boundaries  with  sharp  comers;  but  the 
latter  may  require  a  greater  total  number  of  grid  ceils  to  rq>roduce  the  full 
extent  of  the  recirculation  zone.  Since  bottom  friction  impedes  lateral  flow 
separation  and  reduces  the  lengths  of  computed  eddies,  however,  the  required 
number  of  grid  cells  may  decrease  with  increasing  bottom  friction. 

Unseparated  (nonrecirculating)  flow  requires  considerably  less  grid  resolu¬ 
tion  than  does  separated  flow,  at  least  for  depth-averaged  calculations  in  which 
bottom  friction  is  the  most  important  resisting  force.  An  exception  to  this 
would  be  any  attempt  to  compute  the  flow  in  a  boundary  layer,  which 
STREMR  is  not  designed  to  do  anyway.  The  STREMR  procedure  for  compu¬ 
ting  sidewall  shear  stress  seeks  only  to  model  (roughly)  the  influence  of 
boundary  layers  without  actually  resolving  them. 

The  k-e  turbulence  model  eliminates  the  need  for  guessing  an  eddy  viscos¬ 
ity,  and  the  secondary  flow  correction  accounts  for  the  3-D  influence  of 
streamline  curvature.  Although  the  STREMR  input  includes  several  adjustable 
(empirical)  parameters  that  influence  the  turbulence  and  secondary  flow,  these 
do  not  have  to  be  changed  for  each  new  flow  configuration  or  modeling  effort 
They  are  intended  to  be  universal  constants,  independent  of  the  physical 
setting. 

In  particular,  the  STREMR  version  of  the  k-e  turbulence  model  includes  an 
adjustable  parameter  (RECAP)  that  reduces  the  eddy  viscosity  in  regions  of 
low  velocity  and  high  turbulence.  This  has  little  effect  on  unidirectional  shear 
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flow,  but  it  increases  the  lengths  of  eddies  created  by  obstacles  and  sidewall 
features.  The  default  value  (2.5)  is  slightly  high  to  compensate  for  anticipated 
grid  error  in  recirculating  flow  predictions  made  with  coarse  grids.  With  grids 
fine  enough  to  achieve  grid-independent  predictions,  however,  RECAP  should 
be  given  a  value  between  1.5  and  2.0.  Setting  RECAP  =1.0  imposes  the 
standard  k-£  model,  which  overpredicts  eddy  viscosity  (and  underpredicts  eddy 
size)  for  recirculating  flow. 

The  secondary  flow  correction  enables  STREMR  to  make  credible  flow 
predictions  for  curved  channels  with  nonuniform  bathymetry,  and  it  reproduces 
quantitatively  the  observed  migration  of  high  velocity  toward  the  outsides  of 
channel  bends.  On  the  other  hand,  the  Manning  equation  for  bottom  friction 
could  stand  some  improvement  in  its  prediction  of  the  flow  resistance  on  side 
slopes.  Errors  in  excess  of  15  percent  are  not  uncommon  for  30-deg  slopes 
(with  respect  to  the  horizontal). 

The  technical  development  of  STREMR  is  now  complete.  Future  versions 
of  the  code  may  have  internal  improvements  that  speed  up  execution,  but  the 
input  and  output  variables  are  not  likely  to  change.  The  present  version  runs 
on  any  computer  with  a  FORTRAN  77  compiler  that  supports  namelist  input. 
The  required  memory  depends  on  the  STREMR  array  dimensions  IDIM  and 
JDIM  ,  but  none  of  the  examples  in  Part  V  exceeded  two  megawords.  Execu¬ 
tion  times  may  vary  from  3  rnilliseconds  per  grid  cell  per  time-step  on  a 
20-MHz  personal  computer,  to  0.03  milliseconds  per  grid  cell  per  time-step  on 
a  CRAY  Y-MP  supercomputer.  Re-programming  STREMR  for  automatic 
vectorization  could  speed  up  execution  by  another  factor  of  5  to  10  on  the 
CRAY. 

For  applications  involving  large  amounts  of  input,  even  the  namelist  format 
can  be  cumbersome.  Pre-processors  are  now  under  development  that  will 
allow  users  to  input  flow  parameters  and  bathymetry  data  with  point-and-click 
operations  on  screen,  but  these  will  not  remove  the  option  of  using  namelists. 
Interactive  pre-  and  post-processors  will  simply  be  components  of  an  auto¬ 
mated  ST'REMR  user’s  package.  Thus,  they  will  facilitate  the  manipulation  of 
input  and  output,  but  they  will  not  affect  the  STREMR  code  itself. 
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Appendix  A 
Primary  Fiow 


Notation 


Standard  niiid-mcchanical  notation  is  used  throughout  Appendices  A-F. 
Quantities  defined  in  one  appendix  retain  the  same  definitions  in  subsequent 
appendixes,  except  where  indicated  othc.wise.  All  symbols  with  an  underbar 
represent  vectors,  and  the  subscripts  or,  y,  t,  and  r|  indicate  partial  deriva¬ 
tives.  Other  subscripts  and  superscripts  convey  individual  meanings  that  are 
defined  when  they  are  first  used.  All  references  cited  in  this  appendix  and 
subsequent  appendixes  are  included  in  the  list  of  references  at  the  end  of  the 
main  text. 


Equations  of  Motion 

Depth-averaged  incompressible  flow  (with  a  rigid  lid)  obeys  the  equations 
for  conservation  of  momentum  and  ma.ss,  given  respectively  by 


du  _i 

=  /■  -  p 

dt  -  ^ 


(Al) 


Viiiu)  -  0 


(A2) 


where 

u  =  velocity  vector  (u,v) 

V  =  gradient  operator  (d/dx,d/dy) 
p  =  density 
p  ~  pressure 
i  -  time 
h  =  depth 


Appendix  A  Primary  Flow 


and 


JL  =  1  *  u^V  (A3) 

dt  dt  ~ 


The  operator  d/dt  is  the  total  derivative  with  respect  to  time.  The  vector  F 
includes  the  forces  per  unit  mass  (accelerations)  due  to  viscosity,  bottom  fric¬ 
tion,  and  secondary  flow 

F  =  T-X^S  (A4) 


where 

T  =  viscous  force 
X  -  friction  force 
S  =  secondary  force 

Upon  multiplying  Equation  A1  by  depth  and  taking  the  divergence  thereof,  one 
obtains  a  Poisson  equation  for  the  pressure 


'  du  ] 

=  pV- 

h 

r  ) 

(A5) 


The  solution  of  Equation  A5,  subject  to  the  constraint  of  Equation  A2,  yields 
the  spatial  distribution  of  pressure  needed  to  conserve  mass. 


Viscous  Force 

The  viscous  force  T  has  Cartesian  x-  and  y-components  Tj  and  T2, 
respectively.  These  arise  from  the  divergence  of  the  depth-averaged  shear 
stress 

Ti  =  ^  (^12)y] 


A2 
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T2  =  p'^h  "^[(/n:i2)x  +  (hi2l)y] 

(AT) 

The  subscripts  x  and  y  indicate  partial  jc-  and  ^-derivatives,  and 

Tj!  =  2vp«jj 

(A8) 

T22  =  2vpv,. 

(A9) 

X12  =  vp(Uy  +  Vj,) 

(AlO) 

where  v  is  the  kinematic  eddy  viscosity,  and  Xjj,  X22,  and  Xj2  are  depth 
averaged  components  of  the  turbulent  shear  stress. 

- 

Assuming  that  Equation  A2  is  satisfied,  and  that  derivatives  of  depth 
insignificant  in  the  viscous  terms,  then 

are 

Ti  •"  h  ~\w-(hVu)  +  2Vjf«jc  +  +  Vj^ 

(All) 

T2"  h  "^vV-(/iVv)  +  2v^v^  +  Vjj(Vjj  +  Uy) 

(A12) 

The  second  derivatives  in  Equations  All  and  A12  now  have  the  same  form  as 
those  on  the  left-hand  side  of  Equation  A5,  which  is  convenient  for 
discretization. 

Friction  Force 

Flow  deceleration  caused  by  frictional  resistance  on  the  bottom  is 
rqiresented  in  STREMR  by 
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A3 

X^Cfh~^  u\u 


{A13) 


where  Cy  is  the  bottom  friction  factor.  The  simplest,  and  perhaps  the  most 
widely  used,  approximation  for  Cy  is  given  by  Manning’s  equation 

Cf  =  9.81  n'^  (A14) 


where  n  is  the  Manning  coefficient.  Depth  has  replaced  the  usual  hydraulic 
radius  in  Equation  A14,  and  the  coefficient  9.81  applies  only  when  h  is  given 
in  meters.  Otherwise,  if  depth  is  given  in  feet,  the  coefficient  becomes  14.5 
instead  of  9.81. 


Secondary  Force 

Curved  channels  often  develop  a  helical  secondary  flow  which  creates  a 
shear  stress  in  excess  of  that  produced  by  viscosity.  This  can  result  in  velocity 
distributions  that  are  noticeably  different  from  those  for  purely  two- 
dimensional  flow. 

In  general,  secondary  flow  is  to  be  expected  wherever  the  depth-averaged 
streamlines  are  curved.  This  produces  a  streamwise  acceleration  of  the  depth- 
averaged  flow,  given  approximately  by 


S 


h-'^n-Vifa,)  *2r-h. 


(A15) 


where 

=  secondary  shear  stress 
n  =  unit  vector  normal  to  u 
r  =  local  radius  of  curvature 

The  scalar  product  n^(fnj  is  the  normal  derivative  of  the  dq)th-integrated 
secondary  shear  stress 


rr'VihXs)  = 


(A16) 


A4 
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and  the  radius  of  curvature  is  related  to  the  velocity  derivatives  by 


r 


uv(yy  -  Uj^)  +  -  v^Uy 


(A17) 


The  secondary  stress  is  positive  in  the  direction  of  motion,  and  the  normal 
derivative  and  radius  of  curvature  can  be  either  positive  or  negative.  The  sign 
of  r  (as  given  by  Equation  A17)  is  positive  for  counterclockwise  motion  and 
negative  for  clockwise  motion.  The  normal  derivative  (as  given  by  Equa¬ 
tion  A16)  is  positive  when  hx^  increases  in  the  positive  radial  direction. 
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Background 

Turbulence  occurs  whenever  there  is  too  little  viscosity  to  prevent  small 
disturbances  from  growing  and  disrupting  a  laminar  flow.  The  resulting  eddies 
take  on  so  many  different  sizes  that  it  is  impossible  to  represent  them  all  on  a 
computational  grid  of  reasonable  dimensions.  Nevertheless,  if  the  influence  of 
the  smaller  eddies  can  be  approximated  with  a  turbulence  model,  then  the 
larger  eddies  can  still  be  captured  by  discretization.  The  turbulence,  by  defini¬ 
tion,  then  comprises  only  the  eddies  that  are  too  small  to  be  resolved  directly 
on  the  grid. 

When  the  Navier-Stokes  equations  are  averaged  over  a  time-interval  that  is 
short  compared  with  the  periods  of  the  large  eddies,  but  long  compared  with 
those  of  the  turbulence,  stresses  arise  that  are  proportional  to  the  time-averaged 
products  of  the  fluctuating  velocity  components.  These  are  called  Reynolds 
stresses,  and  the  process  of  time-averaging  is  called  Reynolds  averaging. 

Strictly  speaking,  the  complete  turbulent  velocity  distribution  must  be 
known  in  order  to  calculate  the  Reynolds  stresses  exactly,  but  engineers  gener¬ 
ally  make  do  with  empirical  approximations  based  on  mean-flow  (Reynolds- 
averaged)  velocities.  The  simplest  of  these,  suggested  by  Boussinesq  (1877), 
consists  of  rq)lacing  the  molecular  viscosity  with  an  eddy  viscosity  in  the 
Newtonian  expression  for  shear  stress  (Equations  A8-A10).  Turbulence  models 
that  use  the  Boussinesq  approach  are  called  eddy  viscosity  models,  and  they 
are  classified  according  to  the  manner  in  which  they  obtain  the  eddy  viscosity 
from  the  prq)erties  of  the  local  mean  flow.  Hereafter,  any  reference  to  the 
flow  will  imply  the  mean  flow,  unless  stated  otherwise. 

Since  kinematic  viscosity  has  units  of  length  squared  divided  by  time,  eddy 
viscosity  can  be  made  proportional  to  any  combination  of  turbulence  quantities 
that  yields  these  same  units.  Algebraic  models  obtain  the  eddy  viscosity  by 
caic^ating  turbulence  quantities  directly  from  the  local  flow,  without  account¬ 
ing  for  transit  by  the  flow  itself.  Since  they  involve  no  equations  for  turbu¬ 
lence  transport,  these  models  are  also  called  zero-equation  models.  In  contrast. 
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one-equation  models  include  a  transport  equation  for  one  of  the  turbulence 
quantities,  with  local  algebraic  approximations  for  the  rest.  TWo-equation 
models  add  a  transport  equation  for  a  second  quantity,  and  so  on. 


Depth-Averaged  Turbulence  Modeling 

In  STREMR,  the  friction  force  on  the  bottom  is  presumed  to  account  for 
the  vertical  transport  of  momentum  by  the  turbulence.  This  is  a  crude  repre¬ 
sentation  for  a  phenomenon  so  complex  as  turbulence,  but  it  is  adequate  for 
depth-averaged  calculations  as  long  as  the  lateral  variation  of  depth  is  very 
gentle.  Thus,  the  turbulence  model  u.sed  in  STREMR  must  approximate  only 
the  lateral  transport  of  depth-averaged  momentum.  Two-equation  models  are 
well  suited  for  general  2-D  applications,  because  they  allow  distinct  turbulence 
quantities  to  be  created  in  one  place  and  transported  to  another,  where  their 
influence  is  felt  through  the  eddy  viscosity. 


Standard  k-e  Turbulence  Model 

The  k-e  turbulence  model  (Launder  and  Spalding  1974)  is  one  of  the  most 
widely  used  of  the  two-equation  models.  Here  the  symbol  k  represents  the 
turbulence  energy  (per  unit  mass),  and  e  is  the  dissipation  rate  for  k.  Taking 
these  as  the  primary  turbulence  quantities,  each  of  which  is  governed  by  a 
transport  equation,  the  eddy  viscosity  is  then  related  to  k  and  e  by 


v 


(Bl) 


where  is  a  dimensionless  empirical  coefficient. 

The  governing  equations  for  k  and  e  consist  of  two  semi-empirical  transport 
equations,  each  of  which  has  the  form 

Advection  =  Production  -  Dissipation  +  Diffusion 

Advection  means  transport  by  the  mean  flow;  production  means  creation  from 
the  large  eddies;  dissipation  means  frictional  loss  through  the  small  eddies;  and 
diffusion  means  the  spreading  that  occurs  because  of  eddy  viscosity.  In  the 
standard  k-z  model,  the  depth-averaged  equations  are 


fUL  =vr  -  z  *  Oi~^[h  "^vV<hV/t)  +  VvV*]  (B2) 

dt 


B2 
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J*  =  Cjvrl  -  C2^  >  ae"^[/i“^vV</iVe)  +  VvVc]  (B^) 


The  first  term  on  the  right  of  Equations  B2  and  B3  is  the  production  term, 
which  is  proportional  to 


(B4) 


The  second  term  on  the  right  of  Equations  B2  and  B3  is  the  dissipation  term, 
and  the  quantities  inside  the  brackets  make  up  the  diffusion  term.  The  stan¬ 
dard  set  of  (dimensionless)  empirical  coefficients  is 

=  0.09 
Cj  =  1.44 
C,  =  1.92 

Ot  =  1.0 

a,  =  1.3 

The  governing  equations  for  the  mean  flow  are  the  Reynolds-averaged, 
incompressible  Navier-Stokes  equations.  Their  counterparts  in  STREMR  are 
the  depth-averaged  equations  for  conservation  of  momentum  and  mass  (A1  and 
A2).  By  solving  Equations  B2  and  B3  for  k  and  e,  along  with  Equations  A1 
and  AS  for  u  and  p,  one  can  obtain  mean-flow  approximations  that  are  useful 
within  certain  limits.  Specifically,  when  adequate  approximations  are  imposed 
for  the  shear  stress,  turbulence  energy,  and  dissipation  rate  along  the  sidewalls, 
then  the  standard  k-t  model  works  fairly  well  for  unidirectional  flow.  Some 
modification  of  the  model  is  needed,  however,  for  recirculating  flow. 


Model  Adjustment  for  Recirculating  Flow 

The  standard  k-t  model  sometimes  overpredicts  turbulence  energy  and  eddy 
viscosity  in  regions  of  low  velocity,  and  this  is  especially  a  problem  for  2-D 
recirculating  flow.  In  the  latter  case,  the  overprediction  can  be  reduced  by 
increasing  the  dissipation  rate  in  response  to  low  velocity  and  high  vorticity. 
Previous  work  (Bernard  1991)  has  shown  that  considerable  improvement  can 
be  achieved  by  reducing  the  value  of  C2  to  that  of  as  the  eddy  Reynolds 
number 
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falls  toward  zero.  Tliis  enhances  the  dissipation  rate  for  recirculating  flow 
(where  /?£  becomes  small),  and  it  indirectly  reduces  the  turbulence  energy  and 
eddy  viscosity. 

Since  turbulence  production  rises  also  in  response  to  the  turbulence  energy 
itself,  the  energy  overprediction  can  likewise  be  controlled  by  deflning  an 
energy  ratio 


(B6) 


and  then  redefining  the  eddy  viscosity  as 


V  =  C^ARk)^ 
e 


(B7) 


The  present  version  of  STREMR  uses  Equation  B7  with 


ARk) 


1 

tanh 

i  2\ 

Rk 

R^ 

1  °  / 

(B8) 


where  is  the  maximum  reduction  factor  (RECAP  in  STREMR)  for  the  eddy 
viscosity.  Equation  B8  dictates  that  /(R/^)  -  when  Rj^«  Rq,  and  that 
ARj^  “  1  when  /f^  at  1.7  Rq.  Thus,  /(R^  multiplies  the  standard  eddy  viscosity 
(Equation  Bl)  by  the  factor  i/R^  whenever  the  kinetic  energy  of  the  turbu¬ 
lence  is  comparable  with  that  of  the  mean  How.  Note  that  if  R^  is  set  equal  to 
unity,  then  =  7  and  Equation  B7  reduces  to  the  standard  definition  for 
eddy  viscosity  (Equation  Bl).  Based  on  comparisons  of  STREMR  predictions 
with  test  data  for  recirculating  flow  (Durst  and  Tropea  1981),  it  appears  that 
Rq  lies  in  the  range 
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1.5  s  /fc  s  2.0 


(B9) 


with  Rq  »  65.  Unless  grids  are  used  that  are  flnc  enough  to  achieve  grid- 
independent  flow  predictions,  however,  the  lengths  of  the  computed  eddies  will 
still  be  underpredicted.  The  default  value  in  STREMR  is  set  at  Rq  =  2.5  to 
compensate  for  anticipated  grid  error  on  coarse  grids.  For  modeling  efforts  in 
which  fine  grids  are  employed  to  achieve  accurate  flow  predictions  and  grid 
independence,  Rq  should  always  be  given  a  value  between  1.5  and  2.0. 

Equation  B8  is  not  unique  in  its  ability  to  improve  model  predictions. 

Other  functions  can  be  used  for  f(R0  if  they  reduce  v  dramatically  when  Rj^ 
falls  well  below  Rq.  Of  course,  the  empirical  parameters  Rq  and  Rq  have  to 
be  adjusted  initially  to  reconcile  model  predictions  with  experiment  data,  but 
their  values  are  fixed  thereafter  and  presumed  to  be  universal  constants. 


Model  Adjustment  for  Sidewalls 

Further  adjustment  is  needed  for  sidewalls,  where  gradients  in  both  the 
turbulence  and  the  mean  flow  are  quite  large.  This  complicates  the  problem  of 
modeling  turbulence  close  to  a  wall,  especially  for  boundary  layers  with  strong 
pressure  gradients.  Boundary-layer  calculations  in  general  demand  grid  resolu¬ 
tion  and  turbulence  modeling  on  a  scale  much  finer  than  that  needed  other¬ 
wise.  In  particular,  the  grid  must  be  fine  enough  to  resolve  the  flow  in  the 
boundary  layer  before  and  after  separation;  and  the  model  equations  have  to  be 
altered  considerably  to  approximate  the  velocity,  shear  stress,  turbulence 
energy,  and  dissipation  rate  near  the  wail.  The  extensive  modifications  needed 
for  turbulent  boundary  layers  have  been  discussed  in  detail  by  Patel,  Rodi,  and 
Scheurer  (1985)  in  an  excellent  paper  on  low-Reynolds-number  (near-wall)  k-e 
models. 

STREMR  is  not  intended  as  a  numerical  model  for  boundary  layers,  but  it 
must  approximate  their  influence  well  enough  to  predict  the  flow  at  larger 
scales.  The  main  requirement  is  that  the  combined  effect  of  the  computed 
shear  stress  and  pressure  gradient  should  render  accurate  predictions  of  flow 
sq)aration.  This  calls  for  some  adjustment  of  the  model  equations  next  to 
sidewalls,  but  not  as  much  as  would  be  needed  for  detailed  calculations  in 
boundary  layers. 

The  appropriate  sidewall  adjustments  are  not  known  in  advance,  nor  can 
they  be  deduced  from  scratch.  Moreover,  different  combinations  can  produce 
similar  results.  One  must  simply  make  informed  guesses  for  the  sidewall 
coefflcients  and  boundary  conditions,  and  then  test  the  entire  prescription  by 
comparing  model  predictions  with  physical  measurements.  The  model  adjust¬ 
ments  described  in  the  following  paragraphs  were  developed  in  this  way,  using 
the  separated- flow  experiments  of  Baskaran,  Smits,  and  Joubert  (1987)  as 
benchmarks  for  comparison. 
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To  compute  the  shear  stress  on  a  sidewall,  it  is  necessary  first  to  assume  a 
fun  tional  form  for  the  velocity  near  the  wall.  Although  logarithmic  distribu- 
tio,  have  often  been  used  for  this  purpose,  they  are  generally  applicable  only 
for  weak  pressure  gradients  and  for  grids  that  are  fine  enough  to  resolve 
boundary  layers.  STREMR  applications  typically  involve  strong  pressure 
gradients  and  grids  that  are  too  coarse  for  boundary  layers,  and  it  seems  better 
to  use  a  power-law  velocity  distribution  of  the  form 


=  const  (BIO) 

5I/7 


where  Ug  is  the  tangential  velocity  component,  6  is  the  distance  normal  to  the 
wall,  and  the  1/7  exponent  roughly  approximates  the  velocity  variation  in  a 
turbulent  boundary  layer.  For  small  curvature,  the  tangential  shear  stress  Xg 
now  becomes 


v(6)ug(6) 

75 


(Bll) 


In  STREMR  calculations,  6  is  the  distance  from  the  wall  to  the  center  of  the 
adjacent  NOSLIP  cell,  and  the  shear  stress  at  the  wall  is  taken  to  be 


C£,v(6)«£(6) 

76 


(B12) 


where 


C£)  -  1 


(B13) 


The  coefficient  (DRAG  in  STREMR)  allows  some  adjustment  of  for 
exceedingly  coarse  grids.  Otherwise,  however,  if  the  computational  grid  is 
fine  enough  to  resolve  the  flow  outside  the  boundary  layer  and  downstream  of 
separation,  then  Equation  B12  should  suffice  with  equal  to  unity. 

The  normal  derivative  dk/dd  is  needed  to  compute  the  gradient  flux  of 
turbulence  energy  through  a  sidewall.  Although  k  may  vary  only  slightly  with 
6  throughout  much  of  a  boundary  layer  {dkidb  «  0),  there  is  a  thin  sublayer 
next  to  the  wall  where  k  falls  rapidly  to  zero  (dk/dO  >>  0).  The  sublayer  then 
gives  an  average  value  of  dk/db  that  is  slightly  positive  well  beyond  the  sub¬ 
layer,  and  this  warrants  the  use  of  a  small  positive  exponent  for  the 


B6 
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dependence  of  k  upon  6.  Assuming  that  k  varies  with  the  1/7  power  of  b  near 
the  wall,  then 


m 

51/7 


const 


(B14) 


and  the  normal  derivative  of  k  becomes 


ii  «  (B15) 

db  lb 


Using  the  derivative  given  by  Equation  B15,  STREMR  approximates  the 
gradient  flux  of  k  through  the  wall  with 


dk  ^  \{b)k{b) 
^  °  lb 


(B16) 


Similarly,  the  normal  derivative  dzidb  is  needed  to  compute  the  gradient 
flux  of  the  dissipation  rate  through  a  sidewall.  In  STREMR  calculations,  this 
is  taken  to  be  zero  near  the  wall,  so  the  gradient  flux  of  e  through  the  wall  is 


-  0  (B17) 

db 


Although  e  is  known  experimentally  to  decrease  sharply  with  increasing  6  in  a 
boundary  layer  (dz/db  <<  0),  there  is  an  inflection  point  (dz/db  =  0)  near  the 
wall  where  dz/db  changes  sign.  Whenever  Equation  B17  is  used  as  the  bound¬ 
ary  condition  for  e,  the  presumption  is  that  dz/db  is  negligible  from  the  cell 
center  to  the  wall  (instead  of  at  a  single  inflection  point). 

Equations  B16  and  B17  are  poor  approximations  for  the  gradient  fluxes  of 
k  and  e  near  a  sidewall,  but  their  respective  errors  offset  each  other  somewhat 
in  practice.  In  particular.  Equation  B17  may  underestimate  the  rise  in  e  near 
the  wall,  making  the  dissipation  rate  too  small  to  balance  the  energy  produc¬ 
tion;  but  Equation  B16  imposes  an  additional  loss  of  energy  at  the  wall  that 
partially  compensates  for  the  underpredicted  rise  in  e.  STREMR  carries  this 
compensation  a  step  further  by  setting  C-,  =  Cj  =  1.44  in  all  NOSLIP  cells, 
which  reduces  the  near- wall  decay  rate  for  e. 

The  last  item  needed  in  the  list  of  sidewall  adjustments  is  an  approximation 
for  the  turbulence  energy  production  vf6)r(6)  in  NOSLIP  cells.  This  quantity 
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is  especially  difflcult  to  calculate,  because  it  requires  accurate  approximations 
for  eddy  viscosity  and  the  velocity  derivatives  near  the  wall.  After  much  trial 
and  error,  the  best  approach  seems  to  be  to  compute  the  near-wall  difference 
between  production  and  dissipation  with  the  approximation 


v(8)  r(6)  -  e(6)  -  v(26)  r(26)  -  e{26) 


(B18) 


where 


v(26)  =  ^[v(5)  *  v(36)] 


{B19) 


and 


e(26)  =  ^[e(6)  >  e(38)] 


1 

(B20) 


Note  that  the  center  of  the  NOSLIP  cell  lies  at  a  distance  6  from  the  wall,  and 
that  of  the  adjacent  RELD  cell  lies  at  a  distance  35.  The  velocity  derivatives 
needed  for  r(26)  are  computed  with  central-difference  approximations  at  a 
distance  25  from  the  wall. 


Model  Adjustment  for  Other  Boundaries 

The  normal  derivatives  of  k  and  e  arc  assumed  to  be  zero  on  SLIP 
boundaries  and  OPEN  boundaries.  Along  R,UX  boundaries,  small  fixed 
values,  k  -  kg  and  e  =  are  assigned  in  OUT  cells  adjacent  to  IT,UX  cells. 
These  are  used  in  the  discrete  advective  terms  in  Equations  B2  and  B3,  where 
they  help  prevent  the  computed  values  just  inside  the  grid  from  drifting.  In 
the  diffusion  terms,  however,  the  normal  derivatives  are  set  to  zero  on  FLUX 
boundaries.  Furthermore,  because  of  uncertainties  in  production  and  dissipa¬ 
tion  next  to  these  boundaries,  the  constraint  vF  -  e  =  0  is  imposed  in  all 
FLUX  cells. 

The  values  k  =  kfj  and  e  =  are  assigned  initially  to  the  entire  flow  field, 
but  these  quantities  change  as  the  flow  develops.  If  the  flow  reaches  a  steady 
state,  then  k  and  e  likewise  reach  a  steady  state.  The  initial  energy  kg  is  taken 
to  be  a  small  fraction  (TURBIN)  of  the  initial  velocity  squared  in 

the  reference  cell  (IREF,JREF): 
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TURBIN 
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where  Uq  and  Vq  are  the  reference  velocity  components.  The  default  value  in 
STREMR  is  TURBIN  =  0.003. 

The  initial  dissipation  rate  Zq  is  computed  from  kQ  and  the  initial  eddy 
viscosity  \q  as  follows: 


= 


5V 

Vo 


(B22) 


The  viscosity  \q  is  computed  by  STREMR  to  produce  a  specified  value  for  the 
initial  Peclet  number  (PECLET)  in  the  reference  cell;  i.e. 


PECLET  = 


UqAxo  +  VoAyo 
__ 


(B23) 


where  and  Ayg  are  the  local  x-  and  y-components  of  the  grid  spacing  The 
default  value  in  STREMR  is  PECLET  =  50. 


Turbulence  Model  Applicability 

With  the  proposed  adjustments,  the  k-t  turbulence  model  yields  sidewall 
shear  stresses  that  are  accurate  within  a  factor  of  two,  as  long  as  5  is  roughly  1 
to  10  times  greater  than  the  nominal  thickness  of  the  turbulent  boundary  layer. 
If  6  lies  much  above  this  range,  then  the  grid  is  too  coarse  to  resolve  either  the 
shear  stress  or  the  flow.  When  6  lies  far  below  the  acceptable  range,  the  pre¬ 
dicted  shear  stress  may  be  unacceptably  low.  Fortunately,  however,  predic¬ 
tions  of  flow  sqiaration  seem  to  be  adversely  affected  only  when  the  grid  is 
too  coarse. 

Flow  calculations  in  general  require  that  the  local  grid  spacing  be  suffi¬ 
ciently  fine  to  resolve  the  direction  of  flow  at  comers  and  other  abrupt  changes 
in  the  boundari^.  Just  upstream  of  an  obstacle  or  contraction,  the  computed 
flow  is  quite  sensitive  to  the  pacing  and  orientation  of  the  grid.  Under  these 
conditions,  it  is  necessary  to  try  successively  refined  grids  until  the  same 
results  are  obtained  on  two  different  grids.  Otherwise,  there  is  no  guarantee 
that  the  computed  flow  is  grid  independent. 
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Above  all,  one  should  keep  in  mind  that  the  purpose  of  STREMR  is  not  to 
reproduce  the  details  of  the  turbulence,  but  rather  to  capture  the  large-scale 
features  of  the  2-D  mean  flow.  In  pursuit  of  that  end,  the  k-t  turbulence 
model  allows  STREMR  users  to  concern  themselves  with  bathymetry,  lateral 
geometry,  and  inflow/outflow  distribution,  without  having  to  estimate  local  or 
global  values  for  eddy  viscosity. 


B10 
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Appendix  C 
Secondary  Flow 


Depth-Averaging 

Genuine  two-dimensional  (2-D)  flows  are  uncommon  in  hydraulics,  but 
quasi-2-D  flows  are  common  enough  to  warrant  the  implementation  of  2-D 
dq)th-averaged  models  like  STREMR.  Depth-averaging  cannot  account 
directly  for  vertical  motion,  but  it  can  account  indirectly  (albeit  empirically) 
for  vertical  inhomogeneity.  Thus,  meaningful  calculations  for  shallow  water 
must  include  adjustments  for  effects  that  have  their  origins  in  three 
dimensions. 

Bottom  friction  and  turbulence  are  universally  important,  but  there  is  a  third 
mechanism  that  dq>ends  on  geometry.  When  the  depth-averaged  streamlines 
are  curved,  centrifugal  forces  create  a  streamwise  torque  that  generates  belicity 
in  the  flow.  This  is  like  a  screw  advancing  or  retreating  in  the  streamwise 
direction,  which  makes  fluid  particles  follow  spiral  paths.  The  shear  stress 
produced  by  the  out-of-plane  motion  may  noticeably  affect  the  dq)th-averaged 
flow. 

Helical  secondary  flow  is  well  known  for  slender  meandering  channels, 
where  it  alters  the  depth-averaged  flow  (and  ultimately  the  bed  itself).  It  has 
often  been  simulated  with  algebraic  and  numerical  models  for  slender  channels 
(for  which  a  uniform  curvature  can  be  specifled),  but  these  channels  encompass 
only  a  few  of  the  planview  geometries  that  STREMR  seeks  to  represent  For 
dq)th-averaged  calculations  in  general,  one  needs  a  secondary  flow  model  that 
re^nds  to  dynamic  changes  in  streamline  curvature. 

AbsCTce  of  detail  is  accqitable  for  the  secondary  flow  as  long  as  the  d^th- 
averaged  velocities  are  adequately  predicted.  Ibus,  the  model  should  include 
just  enough  detail  to  approximate  the  depth-averaged  shear  stress  x^.  That  is 
the  guiding  principle  for  the  idealized  picture  adopted  in  SITREMR. 
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Secondary  Shear  Stress 


Let  z  be  the  vertical  direction,  and  let  U(z)  be  a  z-dependent  perturbation  of 
the  dq)th-averaged  velocity  vector  u.  With  the  water  surface  (rigid  lid)  at  z  = 
hl2  and  the  bottom  at  z  =  -h/2,  the  perturbation  must  satisfy  the  constraint 

(C.) 


If  one  substitutes  u  +  u'  for  u  when  deriving  the  depth-averaged  momentum 
equation,  there  arises  a  perturbation  hx'  of  the  dqjth-integrated  shear  stress 
hii2 


h/2 

-hH 


u'v'  dz 


(C2) 


where 

u’  -  x-component  of  u' 
v'  =  y-component  of  «' 

Even  though  the  dq>th  integrals  fu'dz  and  fv’dz  are  both  identically  zero,  the 
perturbation  stress  x'  is  not  necessarily  zero.  The  simplest  functions  that 
satisfy  Equation  Cl  but  leave  x'  nonzero  are 


II 

N 

(C3) 

v'  =  -KUj  Z 

(C4) 

where 

(Oj  =  x-component  of  depth-averaged  vorticity 
0)2  =  y-component  of  depth-averaged  vorticity 

If  the  primary  flow  is  in  the  x-direction,  so  that  v  s  but  u  0,  then  toj  is  the 
streamwise  vorticity  associated  with  out-of-plane  (spiral)  motion  of  the  fluid 
particles.  The  other  vorticity  component  0)2  is  perpendicular  to  and 
characterizes  the  skewness  (z-dependence)  of  the  streamwise  velocity  in  the 
vertical  plane  of  flow.  Upon  substitution  of  Equations  C3  and  C4  into  C2, 
there  results 
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Following  Johannesson  and  Parker  (1989),  let  u>2  be  roughly  prqportional  to 
such  that 


u 

a>2  -  C2— 


(C6) 


where  C2  is  the  constant  of  proportionality.  Equations  CS  and  C6  then  yield 


(C7) 


Assuming  that  Equations  C6  and  C7  are  valid  regardless  of  the  direction  of  the 
velocity  (i.e.,  with  u  r^laced  by  /uf),  one  can  then  approximate  the  deptb- 
avo'aged  secondary  shear  stress  with  the  relation 


Xs  =  phSl^  [mI 


(C8) 


where 


Q  * 


12 


(C9) 


and  0)^  is  the  streamwise  vorticity.  This  leaves  only  Q  to  be  determined  in 
order  to  calculate 


Streamwise  Vorticity 

Consider  a  vertical  column  of  water  in  a  flow  that  has  radius  of  curvature  r 
in  planview.  Let  the  streamwise  velocity  u^z)  be  given  by 
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(CIO) 


I  with  the  outward  radial  velocity  u^z)  given  by 


(Cll) 


At  any  elevation  z,  there  is  a  centrifugal  (outward  radial)  acceleration,  u 
due  to  the  curvature.  This  creates  a  torque  per  unit  mass,  zuj^/r,  along  the 
column.  Assuming  that  the  no-slip  condition  holds,  and  that  there  is  a  vertical 
eddy  viscosity  prc^Ktrtional  to  ,  then  there  is  a  radial  shear  stress,  roughly 
proportional  to  phai^c/^^luj,  at  the  bottom  of  the  column.  Subject  to  these 
forces,  conservation  of  angular  momentum  for  the  column  requires  that 


where  Cj  is  a  constant  of  proportionality.  When  Equations  CIO  and  C12  are 
combined  and  integrated,  there  follows 

^  Jsi!  -  6C,yE7a.,  M  (C13) 

dt  ^  rh  ^  ^  h 


Substitution  of  Equation  C9  into  C13  then  results  in 

^  M  <«<) 

dt  6  f  rh  h 


Equation  C14  shows  the  dependence  of  dOHdt  on  the  streamwise  velocity,  the 
radius  of  curvature,  the  depth,  the  friction  factor,  and  Q  itself.  Its  functional 
form  comes  from  the  assumed  z-dependence  of  the  streamwise  and  out-of¬ 
plane  velocities,  and  from  the  imposition  of  centrifugal  and  frictional  forces  on 
a  vertk^al  column  of  water.  The  constants  and  C2  are  arbitrary,  and  they 
have  to  be  inferred  from  experimental  data,  without  which  Equation  C14  is 
only  of  qualitative  value. 


C4 
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The  right-hand  side  of  Equation  C14  contains  empirically  derived  terms  for 
production  and  dissipation  (damping)  of  Q.  If  one  regards  Q  as  being  truly 
proportional  to  streamwise  vorticity,  then  the  governing  equation  should 
include  terms  for  diffusion  and  vortex-stretching  as  well.  The  vortex- 
stretching  term,  proportional  to  Q-Vu,  will  be  insignificant  compared  to  the 
advection  term  « ’VQ  as  long  as  lhQ.1  is  small  compared  to  /«/.  With  its 
empirical  coefficients  rearranged  and  turbulent  diffusion  added,  Equation  C14 
gives  way  to  the  following  depth-averaged  equation  for  Q: 


do. 

IF 


VvVQ 


where 


=  empirical  coefficient  (ASEC  in  STREMR) 

Dj  =  empirical  coefficient  (DSEC  in  STREMR) 

From  experience  gained  to  date  (Bernard  and  Schneider  1992),  it  appears  that 
suitable  values  for  and  are 

«  5.0  (C16) 


D,  «  0.5 


(C17) 


Equation  C15  is  valid  only  when  h  «  r.  Otherwise,  the  depth  is  compa¬ 
rable  to  the  radius  of  curvature,  and  the  source  term  (i.e.,  the  first  term)  on  the 
right-hand  side  of  Equation  C15  may  become  much  larger  than  is  physically 
reasonable.  To  avoid  this  problem,  the  source  term  can  be  multiplied  by  a 
self-limiting  function  such  that  Equation  C15  gives  way  to 


dQ 

IF 


l«l^ 

rh{l  9/j^/r^) 


+  j  VihVQ)  +  Vv'VQ 


(CIS) 


This  leaves  Equation  C15  essentially  unaltered  for  h  <<  r,  but  it  reduces  the 
source  term  by  a  factor  of  10  when  b  =  r. 
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Equations  C8  and  Cl  8  are  the  equations  used  for  secondary  flow  in 
STREMR.  In  order  to  complete  the  empirical  model,  however,  it  is  necessary 
to  specify  boundary  conditions  for  Q. 


Boundary  Conditions 

In  the  implementation  of  Equation  C18,  one  assumes  that  the  secondary 
flow  is  created  entirely  within  the  computed  flow  field,  and  that  no  streamwise 
vorticity  is  brought  in  from  upstream.  Thus,  Q  is  fixed  at  zero  for  the  inflow 
boundaries,  and  extrapolated  from  the  interior  for  all  other  boundaries. 

Production  of  O  should  approach  zero  on  the  sidewalls,  where  the  stream- 
wise  velocity  decreases  rapidly.  In  order  roughly  to  account  for  this, 

STREMR  reduces  by  one-half  in  all  boundary-adjacent  cells,  which  results 
in  smaller  values  of  Q  near  the  sidewalls. 

While  Equation  C18  is  important  for  the  creation  and  propagation  of  £2,  it 
is  the  sidewall  boundaries  and  the  depth  variations  that  induce  the  largest  gra¬ 
dients  in  hx^  normal  to  the  streamwise  direction.  The  importance  of  the  side- 
walls  has  been  clarified  by  Johannesson  and  Parker  (1989)  who  demonstrated 
that  the  sidewall-induced  normal  derivatives  are  necessary  for  the  gradual 
migration  of  higher  velocities  toward  the  outside  of  a  channel  bend. 


Model  Applicability 

From  the  development  of  Equations  C8  and  C18,  it  should  be  evident  that 
the  proposed  secondary-flow  model  is  certainly  no  substitute  for  computation 
in  three  dimensions.  Nevertheless,  the  balance  of  advection,  diffusion,  produc¬ 
tion,  and  dissipation  yields  the  same  pattern  of  development  and  decay  that  is 
commonly  observed  for  shallow  flows.  Helicity  arises  wherever  the  stream¬ 
lines  are  curved,  and  this  is  followed  by  a  gradual  redistrfi)ution  of  the  depth- 
averaged  velocities.  Downstream  of  the  curved  region,  the  secondary  flow 
dies  off  but  continues  to  influence  the  depth-averaged  flow  for  some  distance. 
Eventually  the  effects  of  upstream  curvature  are  lost  through  bottom  friction 
and  diffusion. 
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Curvilinear  Coordinates 


Boundary-Conforming  Grids 

Irregular  boundaries  are  common  in  hydraulics,  and  these  can  make  finite- 
difference  discretization  cumbersome  for  Cartesian  grids  with  rectangular  cells. 
These  grids  require  that  smooth  curves  and  line  segments  be  replaced  with 
staircases  that  poorly  represent  the  physical  shapes,  and  they  make  it  difficult 
to  maintain  tangency  of  the  velocity  and  to  impose  Neumann  conditions  along 
boundaries  so  represented. 

With  numerically  generated  curvilinear  grids,  however,  it  is  possible  to  fit 
the  gridlines  to  the  boundaries,  and  to  avoid  stair-stepping  altogether 
(Thompson  ct  al.  1985).  The  only  catch  is  that  one  must  transform  the 
governing  equations  from  Cartesian  coordinates  to  general  curvilinear  coordi¬ 
nates,  Thus,  for  the  equations  in  Appendices  A-C,  transformations  have  to  be 
found  for  the  gradient,  divergence,  and  Laplacian  operators. 


Transformation  of  the  Gradient 

Let  the  two-dimensional  curvilinear  coordinates  (^rj)  be  arbitrary  functions 
of  the  Cartesian  coordinates 


(Dl) 

=  ^(x,y) 

(D2) 

Transformation  of  the  gradient  for  these  coordinates  is  contingent  upon  the 
chain  rule,  which  states  that 
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D1 


(D3) 


D2 


and 


%  *  *  yt{^y 


(D4) 


where  t|)  is  an  arbitrary  scalar  function,  and  the  subscripts  ^  and  r|  indicate  %- 
and  T^-derivatives.  Upon  solving  Equations  D3  and  D4  for  the  x-  and  y- 
derivatives  of  \p,  one  obtains  the  x-  and  y-components  of  the  gradient. 


-y^%) 


(D5) 


(D6) 


The  quantity  J  is  the  Jacobian  of  the  transformation,  given  by 


^  =  X|yT,  -  Vl 


(D7) 


When  Equations  DS  and  D6  are  inserted  into  the  Cartesian  expression  for 
u^q>,  they  yield  the  transformed  operation  for  dq)th-averaged  advection 


H’Vip  =  h  “V 


(D8) 


where  U  and  V  are  components  of  volumetric  flux  in  the  and  r|-directions, 
req;)ectively, 


U  =  h(y^u  -  x^v) 

(D9) 

V  =  h(x^v  -  y|«) 

(DIO) 
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Transformation  of  the  Divergence 


The  divergence  of  a  vector  (e.g.,  V  ihuj)  is  defined  by  the  Gauss  Theorem, 
which  says  that  for  an  arbitrary  volume  with  total  surface  area 

dV,  =  ««  (Dll) 


where 

=  differential  volume 
dS^  =  differential  surface  area 
n  =  unit  vector  (outward)  normal  to  dS^ 

Consider  an  infinitesimal  cube  in  a  three-dimensional  curvilinear  (^11,2)  space 
in  which  z  is  an  indqrendent  coordinate  direction,  normal  to  both  the  Cartesian 
(x,y)  and  curvilinear  (^t])  planes.  Cube  faces  of  constant  ^  and  constant  t) 
then  have  surface  areas  given,  respectively,  by 


=  dzdr\ 


(D12) 


j  2  2 


(D13) 


The  unit  vectors  normal  to  these  faces  are,  re^ectively,  given  by 


«»)= 

-  w 


Vti 

w 


(D15) 


To  evaluate  the  gradients  in  D14  and  DIS,  one  substitutes  |  and  t]  for  ip  in 
Equations  DS  and  D6.  Since  ^  and  t)  are  independent  of  each  other,  it  follows 
immediately  that 


Appendix  D  Curvilineer  Coordinetes 


03 


(D16) 


D4 


=  (D17) 


and 

=  -J  "  V| 


(D18) 


r\y  =J  ^ 


(P19) 


Then  after  substituting  hu  and  hv  for  in  Equations  D5  and  D6,  and  using  the 
results  with  Equations  D12-D19,  it  is  easy  to  obtain  the  scalar  product 
nfhuJdS^  for  toe  constant-^  and  constant-rj  faces  of  the  cube,  respectively 

=  U  dzdx]  (D20) 


=  V  dzd% 


(D21) 


where  U  and  V  are  given  by  Equations  D9  and  DIO,  respectively.  Assuming 
no  variation  of  A  or  u  in  the  z-direction  for  the  infinitesimal  cube,  the  right- 
hand  side  of  Equation  Dll  is 


where 
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) 


■4* 


(D24) 


To  evaluate  the  left-hand  side  of  Equation  Dll,  it  is  necessary  to  obtain  an 
expression  for  the  infinitesimal  volume  dV^.  Let  r,  ^  and  k  be  unit  vectors  in 
the  X-,  y-,  and  z-directions,  respectively.  Infinitesimal  displacements  d^,  dr], 
and  dz  in  the  curvilinear  d.rj.z)  space  produce  inf-nitesimal  vector  displace¬ 
ments  in  the  Cartesian  (x,y,z)  space  ;  i.e. 


=  (i  +  i  3*^)  (^25) 

d^'^  =  (ix^  *  ly^)(h\  (^26) 

=:  kdz  (D27) 


where 

d^^^^  =  displacement  with  constant  r)  and  z 
dx^^^  =  displacement  with  constant  %  and  z 
d^^  =  displacement  with  constant  |  and  ti 

In  curvilinear  (^ii,z)  space  the  displacements  d^,  dt],  and  dz  coincide  with 
three  intersecting  edges  of  the  infinitesimal  cube;  but  the  conesponding  vector 
displacements  in  Cartesian  (x,y,z)  space  (Equations  D2S-027)  coincide  with 
three  intersecting  edges  of  an  infinitesimal  parallelipiped.  The  volume  of  the 
latter  is  given  by  the  triple  scalar  product 


dVc  =  X 


(D28) 


Combining  Equations  D25-D28  then  produces 
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D5 


dVf.  -  J  ^dr\dz 


(D29) 


After  substituting  the  right-hand  side  of  Equation  D29  for  dV^  in  Equa¬ 
tion  Dll,  and  equating  the  result  with  the  right-hand  side  of  Equation  D22,  the 
limit  as  dr\,  and  dz  approach  zero  gives 

V-Ihu]  =  J  +  V^]  (D30) 


where  U  and  V  are  the  and  T)-components  of  volumetric  flux  given  by  Equ¬ 
ations  D9  and  DIO,  respectively. 

Lest  there  be  confusion  about  the  z-coordinate  and  the  depth  h  in  this 
appendix,  note  that  z  is  used  only  to  establish  a  coordinate  direction  for  the 
displacement  dz,  which  is  needed  for  defining  infinitesimal  volumes  and  sur¬ 
face  areas.  In  the  limit,  dz  divides  out  of  Equation  Dll,  and  the  final  result 
(Equation  D30)  collapses  into  two  dimensions.  The  depth  h  and  velocity  u 
play  the  respective  roles  of  arbitrary  scalar  and  vector  in  the  derivation,  but 
their  product  hu  is  convenient  for  demonstration  because  it  appears  in  the 
continuity  equation  (A2). 


Transformation  of  the  Laplacian 

With  curvilinear  expressions  in  hand  for  the  gradient  and  the  divergence,  it 
is  straightforward  to  transform  the  generalized  Laplacian,  Vf/iVip),  in  which 
and  Ip  play  the  same  roles  as  u  and  v,  respectively,  in  the  left-hand  side  of 
Equation  1)30.  Thus,  it  follows  that 


V</iVtp)  =7 


(D31) 


where  and  are  given  by  Equations  D5  and  D6.  There  is  little  point  in 
further  reducing  Equation  D31,  however,  without  first  discussing  how  it  is  to 
be  discretized. 


D6 
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Appendix  E 
Discretization 


Computational  Coordinates 

STREMR  uses  a  marker-and-cell  (MAC)  grid  (Figure  2)  for  discretizing  the 
equations  in  Appendices  A-C,  assuming  that  they  have  been  converted  from 
Cartesian  coordinates  {x,y)  to  curvilinear  coordinates  with  the  transforma¬ 
tions  given  in  Appendix  D.  The  computational  counterparts  of  the  curvilinear 
coordinates  (^t])  are  the  integer  computational  coordinates  The  grid  cells 
may  have  any  shape  in  the  Cartesian  (jt,)*)  plane,  but  they  are  rectangular  in  the 
computational  {i,j)  plane.  All  discrete  calculations  are  done  in  the  computa¬ 
tional  plane,  in  which  the  grid  cells  are  uniformly  square  with  sides  of  unit 
length 


=  Ari  =  1 


(El) 


The  lengths  of  the  cell  sides  in  the  Cartesian  plane  can  be  found  from  Equa¬ 
tions  D12  and  D13.  The  computational  coordinates  define  the  locations  of  the 
grid  nodes  (Figures  2  and  3)  as  well  as  the  integer  values  or  the  curvilinear 
coordinates: 


I  =  i 


(E2) 


(E3) 


The  curvilinear  coordinates  of  the  cell  centers  (|(.c'’^cc)  given  by 


I 


cc 


(E4) 
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^cc  -J  -  ~ 


(E5) 


Thus,  the  computational  (ij)  plane  and  the  curvilinear  (^r])  plane  are  identical. 
As  discussed  in  Part  11,  the  indices  (i,f)  also  serve  as  labels  for  cell  (i,j)  whose 
northeast  comer  lies  at  node  (i,f)  in  the  computational  plane. 


Marker-and-Cell  Grid 


Each  cell  has  distinct  quantities  defined  for  the  cell  center  and  for  the  mid¬ 
points  of  the  cell  faces.  The  cell-centered  (cell-averaged)  quantities  are  the 
pressure  p,  the  Cartesian  velocity  components  («,v),  the  viscosity  v,  the  dq)th 
h,  the  turbulence  energy  k,  the  turbulence-energy  dissipation  rate  £,  and  the 
streamwise  vorticity  Q.  The  face-centered  (face-averaged)  quantities  are  the 
volumetric  flux  components  (f/,V),  with  U  defined  on  the  east  and  west  faces, 
and  V  defined  on  the  north  and  south  faces. 


Coordinate  Derivatives 

The  nodal  coordinates  x(i,j)  and  y(i,j)  coincide  with  the  northeast  comer  of 
cell  (4/);  but  on  the  east  face  as  a  whole,  the  central-difference  approximation 
for  X|  requires  cell-centered  coordinates: 


(E6) 


The  subscript  cc  denotes  cell-centered  (cell-averaged)  quantities,  where 

^ccOV) =-5-  [  j)  +x(i-l  j-1)]  (E7) 
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Either  nodal  or  cell-centered  coordinates  can  be  used  for  central-difference 
approximations  of  on  the  east  face;  i.e., 


-  /-!)] 


(E8) 


E2 
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(E9) 


x(y-l) 


Hie  superscripts  e  and  E  both  indicate  the  east  face;  but  the  lower-case  e 
refers  to  the  derivative  computed  with  cell-centered  coordinates,  while  the 
upper-case  E  refers  to  the  derivative  computed  with  nodal  coordinates.  The 
same  convention  ^plies  for  superscripts  referring  to  derivatives  of  x  and  y  on 
the  north  {n,N),  south  {s,S),  and  west  (w,W)  faces.  For  example,  on  the  north 
face 


(ElO) 

(Ell) 

=  x(ij)  -  x(i-lj) 

(E12) 

Coordinate  derivatives  are  also  needed  at  the  cell  centers.  These  are  indicated 
by  the  superscript  c  (lower  case)  and  computed  from  nodal  coordinates  by 
using  central-difference  approximations: 

(E13) 

\  "T  J-1)] 

(E14) 

Henceforth,  the  upper-  and  lower-case  conventions  for  superscripts  will  also 
apply  for  subscripts. 

Generalized  Laplacian 

Coordinate  derivatives  using  nodal  coordinates  are  needed  for  computing 
fluxes  through  the  cell  faces,  and  coordinate  derivatives  using  cell-centered 
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E3 


coordinates  are  needed  for  computing  other  derivatives  on  the  cell  faces.  For 
example,  the  components  of  Vip  on  the  east  f«:e  are 


'fj '4] 

where 

,  e  e  e  e 
>’r,  -^>'1 

-  M}J) 

M  4 

For  Ar  =  i,  however,  the  flux  of  Vip  through  the  east  face  is 

Ukewise,  the  flux  of  Vip  through  the  north  face  is 

'fj  ->■” 

where 

«  --if  »  ,«  «  1 

'fx  =-^«  K  '1^  %] 


(E15) 

(E16) 

(E17) 

(E18) 

(E19) 

(E20) 

(E21) 

(E22) 
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,n  ,-lf  n.B  «.«! 

%  “  [•*!  %  ■  -^Tj  1 

(E23) 

II 

1 

Jm 

(E24) 

-  Mij) 

(E25) 

(E26) 

Similar  arguments  apply  for  the  south  and  west  faces.  Substitution  of  these 
relations  into  Equation  D31  yields  a  discretized  Laplacian  that  is  the  sum  of 
four  gradient  fluxes 

Jc  •  I'eO'.f  'I’x  -  Jt®  vj)  -  < 

.i./N,n  N.Ux  i./Ss  S.Sv 

+  hn(*i  %  -  y§  't’x)  ■  'I'y  -  y|  'Px) 

W  w. 

'Py)  (E27) 

where 

r  C  C  C  C 

■^c  =  ^T,  -  '‘q 

(E28) 

Cell-centered  depths  are  averaged  for  adjacent  cells  to  get  dq)ths  on  their 
common  faces;  e.g. 

(E29) 

*B  =  *  KU*^)] 

(E30) 
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After  all  the  terms  and  coefficients  have  been  expanded  for  Equation  E27,  the 
discretized  Laplacian  takes  the  final  form 


Jc  V</iVip)  =  AccMij)  * 

(E31) 

+  AngiKi+lJ+l) 

Anw'Ki-lJ+l)  +  Ase^K‘+lJ-l)  +  Aj^iKi-lj-l) 

For  cells  not  adjacent  to  boundaries,  the  A'coefficients  are 


Acc  ~  ~  Pn  Pj 

(E32) 

^ee  =  «€  -  Y„  Yj 

(E33) 

Ayw  -  Y/t  ”  Yj 

(E34) 

Ann  =  Pa  -  Ye  +  Yw 

(E35) 

Aji  “  Ps  Ye  ~  Yyv 

(E36) 

Anc  ~  ”Yn  “  Ye 

(E37) 

Antv  “  Yn  *  Iw 

(E38) 

Ajm*  ~  ~  Yh* 

(E39) 

Aje  ~  Yj  *  1e 

(E40) 

and  the  a-,  P-,  and  y-coefficients  for  all  cells  are 


f  £  e  E 


(E41) 
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(E42) 


o  *n  f  JV  n  N  n 


E  e  E  e 

I  JCfc  +  v„  Vfc 

L  11  I  -'ll 


(E43) 


Yb 


(E44) 


The  corresponding  formulas  for  the  west  and  south  faces  are  identical  to  Equa¬ 
tions  E41-E44,  except  that  (w,W)  and  (s,5)  replace  {e,E)  and  (n^A/), 
respectively,  as  the  subscripts  and  superscripts. 

Equation  E31  represents  the  discretized  Laplacian  for  any  cell -centered 
quantity,  and  the  same  A-coefficients  (given  by  Equations  E32-E40)  can  be 
used  for  the  momentum  equation  (Al),  the  Poisson  equation  for  pressure  (A5), 
the  turbulence  equations  (B2  and  B3),  and  the  secondary  flow  equation  (Cl  8). 
Moreover,  since  the  A-coefficients  are  constants,  they  have  to  be  calculated 
only  once  for  a  given  flow  geometry. 


Laplacian  for  Boundary  Cells 

Equation  E31  requires  cell-centered  values  for  coordinates  and 

dependent  variables  in  OUT  cells.  Suppose,  for  example,  that  cell  (i,J)  is  a 
boundary  cell,  and  that  the  cells  to  the  right  are  OUT  cells.  Two  apparent 
dilemmas  then  arise.  First,  Equation  E27  demands  that  the  gradient  flux 
through  the  east  face  be  uniquely  specified  (as  defined  by  Equation  E20). 
Second,  Equations  E22  and  E23  demand  that  ^-derivatives  be  computed  for  x, 
y,  and  rp  on  the  north  and  south  faces.  According  to  Equations  Ell  and  E26, 
these  derivatives  would  need  cell-centered  quantities  for  cells 
(*+i,;+J),  and  (i+lj-l),  all  of  which  are  OUT  cells. 

The  resolution  of  the  first  dilemma  is  straightforward.  One  simply  replaces 
the  east  flux  in  Equation  E27  with  a  known  value  (given  in  advance),  and  then 
expands  the  three  remaining  fluxes  to  obtain  expressions  for  the  A-coefficients 
that  appear  in  Equation  E31.  In  STREMR  the  boundary  value  for  the  gradient 
flux  is  always  set  equal  to  zero  so  that  the  A-coefficients  will  be  the  same  for 
all  cell-centered  variables.  Nonzero  boundary  values  are  subsequently  added 
(as  needed)  to  the  explicit  Laplacian  for  each  dependent  variable. 

The  A-coefficients  cannot  be  calculated,  however,  until  the  second  dilemma 
is  resolved.  The  problem  is  that  Equations  Ell  and  E26  include  values  that  lie 
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in  OUT  cells,  and  it  appears  that  one  must  either  extrapolate  known  values 
across  the  grid  boundary,  or  use  difference  equations  other  than  Ell  and  E26. 
The  two  alternatives  are  equivalent,  and  previous  work  (Bernard  and  Kapitza 
1992)  has  demonstrated  that  when  the  east  face  of  a  cell  coincides  widt  a 
boundary.  Equations  Ell  and  E26  should  be  rqilaced  with 


(E45) 


These  are  one-sided  difference  approximations,  but  the  same  effect  can  be 
achieved  by  using  the  following  extrapolations  in  Equations  Ell  and  E26: 


=  ^ccOj)  - 

(E47) 

-  mi-lj) 

Either  way,  Uie  nonzero  A-coefficients  turn  out  to  be. 

(E48) 

^cc  =  -  Pn  -  Pj  -  2y„  2Yj 

(E49) 

2y„ 

(E50) 

^ss  “  Ps  ”  Yw  2Ys 

(E51) 

^ww  ~  ~ 

(E52) 

^nw  =  2y„  +  Ymt 

(E53) 

^sw  ~  “^Ys  "  Ymt 

(E54) 

and  three  of  the  coefficients  are  identically  zero;  i.e.. 


E8 
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(E55) 


~  ^ne  ~  ^se  ^ 

This  is  only  one  example  of  the  special  treatment  needed  in  deriving  the 
A-coefncients  for  a  boundary-adjacent  cell,  but  the  same  principles  apply  for 
any  cell  that  has  at  least  one  entire  /ace  on  a  boundary. 

A  different  situation  that  requires  special  treatment  is  one  where  a  cell  has 
only  one  comer  touching  a  boundary.  Consider  a  cell  (4/)  for  which  only  the 
northeast  comer  lies  on  a  boundary.  Among  the  immediate  neighbors  of  ceil 
(i,/),  only  cell  (i+lj+l)  is  an  OUT  cell.  In  this  case,  none  of  the  gradient - 
fluxes  is  identically  zero  in  Equation  E27,  but  Equations  E8,  Ell,  E19,  and 
E26  still  require  cell-centered  quantities  in  cell  One  way  out  of  the 

ambiguity  is  to  use  Equations  E45  and  E46  in  place  of  Ell  and  E26,  and  to 
replace  Equations  E8  and  E19,  re^ectively,  by 


\  -^ccOV-l) 


(E56) 


(£57) 


With  these  modifications,  the  A-coefficients  now  become 


‘cc 


'nn 


‘ee 


‘HW 


‘BC 


=  “«e  -  «H-  -  Pn  -  Ps  -  2Y„  -  2y^ 

(E58) 

=  P«  -  2Tr„  +  Yh- 

(E59) 

=  Pi  ^  2ye  -  Yh- 

(E60) 

=  -  2Ye  +  Ys 

(E61) 

=  +  2yg  -  Yi 

(E62) 

=  0 

(E63) 
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^nw  =  2y„  +  Yw 
^st  ~  2^6  Yj 
^sw  ~  “Ys  ”  Ym> 


(E64) 

(E65) 

(E66) 


Conservation  of  Mass 

It  is  easy  to  see  from  Equations  A2  and  D30  that  in  the  |T]-plane,  the  con¬ 
tinuity  equation  (for  conservation  of  mass)  gives  way  to  the  simple  constraint 


U^*Vj^=0  (E67) 

In  discrete  form,  this  reduces  to  a  balance  of  the  fluxes  through  the  four  faces 
of  each  grid  cell;  i.e. 

UE-Uw*Vff -Vs  ^0  (E68) 


where 


E  E 

^E 


N  N 

^  “jv 


(E69) 


(E70) 


with  similar  expressions  for  the  west  and  south  faces.  The  upper-case  sub¬ 
scripts  for  u  and  v  indicate  that  the  face-centered  velocity  components  are  not 
to  be  calculated  simply  by  averaging  cell-centered  values,  but  are  to  be 
obtained  by  some  other  means. 

Suppose  there  exists  a  flux  distribution  (C/'.K)  that  does  not  satisfy 
Equation  E68;  i.e. 


(E71) 


E10 
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The  distribution  (U',V)  can  be  made  to  conserve  mass  by  adding  the  gradient 
of  a  scalar  function  (t>,  such  that 


(E72) 


N 


{E73) 


Substitution  of  Equations  E72  and  E73  (with  similar  expressions  for  the  west 
and  south  faces)  into  Equation  E68  produces  a  discretized  Poisson  equation 


(E74) 


If  no  changes  are  demanded  for  the  fluxes  through  the  boundaries  (i.e.,  if  the 
boundary  fluxes  are  given  correctly  in  advance),  then  the  function  (j)  is  subject 
to  the  same  constraints  as  the  function  tp  (Equations  E27  and  E31),  and  their 
discretized  Laplacians  are  identical. 

Now  suppose  that  at  some  time  t  the  flow  conserves  mass.  Let  If  and  V 
be  the  fluxes  that  would  exist  if  the  flow  were  allowed  to  evolve  from  /  to  /  + 
At  without  a  pressure  gradient.  The  pressure  needed  to  achieve  conservation  of 
mass  at  the  end  of  this  interval  is  then  related  to  the  solution  of  Equation  E74 
by 


p  =  fi.  (E75) 

At 

Even  if  the  flow  did  not  conserve  mass  at  time  I,  the  pressure  given  by 
Equation  E75  would  make  it  do  so  at  time  t  +  At.  Thus,  by  solving  Equa¬ 
tion  E74  iteratively  in  each  discrete  time-step  through  which  the  flow  evolves, 
one  is  able  to  maintain  approximate  conservation  of  mass  and  remove  errors 
that  might  be  left  over  from  previous  time-steps.  The  latter  advantage  is 
important  because  it  prevents  accumulation  of  error  caused  by  incomplete 
convergence  in  the  iterative  solution  of  Equation  E74. 


Advection 


Each  of  the  governing  equations  in  Appendices  A-C  contains  an  advection 
term  (i.e.,  «-Vtp),  which  is  perhaps  the  most  troublesome  of  all  the  terms  to 
be  discretized.  It  is  this  term  that  shapes  the  algorithms  in  STREMR,  and  its 
influence  is  best  understood  with  reference  to  the  equation  for  pure  advection 
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%  ii'Vtj)  =  0 


(E76) 


In  general  curvilinear  coordinates,  Equation  E76  becomes 


The  advection  equation  has  long  been  an  object  of  computational  research,  and 
the  prescriptions  for  its  discretizatk>n  are  varied  and  many  (Anderson  et  al. 
1984).  Two  of  the  simplest  are  the  Euler  upwind  scheme  (Anderson  et  al.) 
and  Ae  MacCormack  predictor-corrector  scheme  (MacCormack  1969). 
STREMR  uses  the  MacCormack  scheme  for  the  primary-flow  momentum 
equation  and  the  upwind  scheme  for  the  turbulence  and  secondary  flow 
equations. 

The  Euler  upwind  scheme  favors  propagation  in  the  directions  of  positive  U 
and  V.  Thus,  with  forward  differencing  in  time  and  upwinding  in  space,  the 
advection  equation  takes  the  discrete  form 


=£/(")  [tKtV)  [ Mi-lj)  -'Kv)]  (H78) 

Af 

[iKv)  -'K»V+i)l  -MiJ)] 

where 


-  4[t'£  -  It'El] 

(E79) 

(E80) 

I 

II 

(E81) 

>''■>  ■  4I''*  *  '‘'■''I 

(E82) 

The  quantities  on  the  right-hand  side  jf  Equation  E78  are  those  existing  at 
time  r,  and  the  new  value  of  tp  at  time  r  +  A/  is 


E12 
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tjj  -  +  All? 


(E83) 


where  the  symbol  «  means  that  the  sum  on  the  right  replaces  the  previous 
value  of  the  quantity  on  the  left.  Oose  inspection  of  Eouations  E78-E82 
reveals  that  E78  uses  one-sided  differencing,  because  and  cannot  be 
simultaneously  nonzero,  nor  can  and  \r'K 

The  MacCormack  scheme  also  uses  one-sided  differencing,  but  this  is  taken 
in  opposite  spatial  directions  during  the  predictor  phase  and  the  corrector 
phase.  The  predictor  phase  begins  with 


hJ^  ^  =  U^i-UrJ)l\^i-l*rj)  -  y^hrj)]  (E84) 


The  integer  shift  indices  (r,s)  control  the  direction  of  the  differencing.  Values 
of  1  and  0  produce  forward  and  backward  differencing,  respectively,  and  the 
initial  pair  (r,s)  is  chosen  from  four  combinations:  (0,0),  (1,0),  (0,1),  and 
(1,1).  The  predictor  phase  concludes  with  the  provisional  value  of 


=  tp  +  Aqj 

The  corrector  phase  begins  by  reversing  the  difference  directions  that  were 
used  in  the  predictor;  i.e. 


The  difference  equation  for  the  conector  then  becomes 


(E86) 

(E87) 


(E88) 


Equation  E88  is  used  to  obtain  a  second  pro.  isional  value  of 
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tp**  =  tp*  +  Atp* 


(E89) 


Finally,  the  corrector  phase  concludes  with  the  value  of  tp  at  time  r  +  A/ 


n-  -  +  tp*i  (E90) 

To  avoid  the  accumulation  of  directional  bias  caused  by  repeated  use  of  the 
same  shift  indices,  each  of  the  four  possible  (r,s)  combinations  is  used  (in  the 
predictor  phase)  once  in  every  four  time-steps. 

Qose  inspection  of  Equations  E67  and  E77  reveals  that  if  E67  is  satisfied, 
then  E77  can  be  replaced  by  its  conservative  form 

That  is,  the  advection  operator  can  be  expressed  in  either  of  two  equivalent 
forms 


I/tp|  ^  Vtp^  =  (l/ip)|  ^  (Vip)^  (E92) 

When  the  discrete  continuity  equation  (E68)  is  satisfied  (on  a  MAC  grid),  the 
Euler  upwind  and  MacCormack  schemes  preserve  the  equivalency  demon¬ 
strated  in  Equation  E92  and  achieve  a  true  finite-volume  discretization. 


Cefl'Centered  Velocities 

Prior  to  the  first  time-step  in  a  cold  start,  STREMR  calculates  initial  mass- 
conserving  fluxes  (U,V)  from  the  gradient  of  a  scalar  potential.  These  fluxes 
then  evolve  as  the  flow  evolves,  and  they  are  updated  and  adjusted  for  mass 
conservation  in  each  phase  of  the  MacCormack  predictor-corrector  scheme.  In 
other  words,  the  volumetric  fluxes  (U,V)  are  regarded  as  the  true  dependent 
variables  of  the  flow,  and  the  Cartesian  velocity  components  (m,v)  are  dummy 
variables  that  are  retained  only  temporarily.  Nevertheless,  the  momentum 
equation  and  the  transport  equations  for  turbulence  and  secondary  flow  still 
require  velocities  at  the  cell  centers. 

In  the  Euler  upwind  scheme  used  for  the  turbulence  and  secondary  flow, 
the  cell-centered  velocities  can  be  obtained  simply  by  averaging  the  face- 
centered  fluxes;  i.e. 


El  4 
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(E93) 


u 


U. 


cc 


V 


(E94) 


where 


Vcc  =  jct'e  -  ^w>  (E95) 


Vcc  ’  -  Vs)  (E«) 

Equations  E93-E96  suffice  for  defining  the  velocities  and  the  derivatives 
thereof  needed  in  the  right-hand  sides  of  Equations  B2,  B3,  and  CIS. 

The  cell-centered  velocities  play  a  different  role  in  the  momentum  equation, 
where  they  appear  temporarily  as  the  dependent  variables  of  the  flow.  At  first 
mspection,  there  is  no  obvious  way  of  relating  cell-centered  velocities  to  face- 
centered  fluxes  except  by  averaging  (as  in  Equations  E93-E96).  With  the 
forward-backward  logic  of  the  MacCormack  scheme,  however,  there  is  an 
admissible  alternative. 

Let  the  shift  indices  (r,s)  determine  not  only  the  difference  directions  for 
advection,  but  also  the  cell  faces  and  fluxes  that  will  be  used  for  defining  the 
cell-centered  velocities.  Thus,  let 


U^r)  =  U^i-rJ) 

(E97) 

(E98) 

+  h(i-rj)] 

(E99) 

Ms)  =  *  KiJ-s)] 

(ElOO) 

x^(s)  =  x^(ij-s) 

(ElOl) 

El  5 
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(E102) 


x^(r)  =  x^(i-rj) 

Kf  F 

with  similar  definitions  for  (s)  and  frl-  If  u(r,s)  and  v(r,s)  are  the  cell- 
centered  velocities  defined  by  (r,s),  and  tf  these  velocities  are  used  instead  of 
U£,  V£,  Uff,  and  in  Equations  E69  and  E70,  then 


=  h,(r) 


y-^ir)  u(r,s)  -  x^(r)  v(r^) 


(E103) 


==  *n(^)  -  y^%)  “(m) 


(E104) 


Solving  Equations  E103  and  E104  for  u(r,s)  and  v(r,s),  one  obtains 


«(r^) 


1 

t'W 

J(r,s) 

<■»(*) 


(E105) 


v(m)  = 


J(r^) 


y^(s)  U^r)  ^  yj^{r)  V^s) 
h^)  ^ 


where 


J(M)  =  x^{s)  y^(r)  -  x^(r)  y^(s) 


(E106) 


(E107) 


Equations  E105  and  E106  define  the  velocity  components  to  be  used  in  the 
MacCormack  solution  of  the  discretized  momentum  equation. 


Face-Centered  Flux  Increments 

The  increments  of  velocity  calculated  during  a  predictor  or  corrector  phase 
have  to  be  converted  into  flux  increments  and  transferred  back  to  the  cell  faces 
from  which  the  fluxes  were  taken.  To  accomplish  this,  one  uses  Equations 
E103  and  E104,  with  velocity  increments  (Am,Av)  in  place  of  velocities  (u,v), 
and  flux  increments  (AL/,AV)  in  place  of  fluxes  (l/,V);  i.e. 


E16 
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At/£(r)  =  h^{r) 


HVj^s)  =  (s)  Av(r^) 


>1,  (r)  liu{r^) 


N, 


-i:^^(r)  Av<r^)] 
-  y^{s)  au(m) 


(E108) 


(E109) 


Once  the  flux  increments  have  been  calculated,  the  velocities  and  velocity 
increments  can  be  discarded.  STREMR  computes  the  cell-centered  velocity 
increments  with  the  pressure  gradient  omitted  from  the  momentum  equation,  so 
the  flux  increments  given  by  Equations  E108  and  E109  do  not  conserve  mass. 
These  flux  increments  are  added  to  the  existing  fluxes  to  obtain 


=  U^r)  *  AU^r) 

(El  10) 

(Elll) 

The  nonconservative  fluxes  given  by  Equations  El  10  and  El  11  are  used  in  the 
right-hand  side  of  the  Poisson  equation  (E74),  which  STREMR  solves  itera¬ 
tively  with  a  conjugate-gradient  scheme  developed  by  Kapitza  and  Eppel 
(1987).  The  resulting  scalar  potential  ^  is  then  used  in  Equations  E72  and 
E73  to  correct  V  and  V  for  conservation  of  mass. 

This  procedure  is  carried  out  in  both  the  predictor  and  corrector  phases,  but 
in  the  corrector  phase  the  nonconseivative  fluxes  are  calculated  using 


Vd'")  •  ''>*)  *  iU'Cr*) 


(El  12) 


V’^s^)  =  \[vn(s*)  *  V>*)  AVj;(s*) 


(El  13) 


where 

-  conservative  l/-flux  at  end  of  predictor  phase 
=  conservative  V-flux  at  end  of  predictor  phase 

and 

Af/£  =  nonconservative  t/-increment  for  corrector 
AVff  =  nonconservative  V-increment  for  corrector 
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If  ^  and  p  are  the  scalar  potential  and  pressure,  respectively,  for  the  predictor 
phase,  then ^  is  related  to  ^  by  Equation  E7S.  For  the  corrector  phase, 
however,  p  is  related  to  ((>  by 


E18 


^  2p<j>*  (E114) 

A/ 

The  factor  2  appears  because  the  flux  increments  for  the  corrector  phase  are 
multiplied  by  1/2  in  Equations  E112  and  E113.  The  significance  here  is  that  p 
and  p  each  act  for  half  a  time-step. 


Cell-Centered  Gradients 

The  momentum  equation  and  the  transport  equations  for  turbulence  and 
secondary  flow  all  contain  products  of  first-order  spatial  derivatives;  e.g. 


=  VvVtl)  +  other  terms 
dt 

(El  15) 

The  right-hand  side  includes  |-  and  r]-derivatives  that  have  to  be  evaluated  at 
the  cell  centers.  When  the  Euler  upwind  scheme  is  used  for  advection  of  the 
turbulence  and  secondary  flow,  these  derivatives  are  approximated  with  central 

differences: 

(El  16) 

%  =  -  'Ky-i)] 

(El  17) 

On  the  other  hand,  when  the  MacGormack  predictor-corrector  scheme  is  used 
for  advection  of  the  primary  flow,  the  derivatives  are  represented  with  alternate 
one-sided  differencL'.g  controlled  by  the  shift  indices: 


(El  18) 

(El  19) 

When  Equations  E116-E119  call  for  external  values  of  the  dqith  h  or  the 
transport  variable  outside  the  grid,  these  are  equated  with  values  inside  the 
grid.  Thus,  when  the  east  face  coincides  with  a  boundary 


Appendix  E  Discretization 


(E120) 


The  only  exception  is  when  cell  (i,j)  is  a  FLUX  cell,  in  which  case  the  exter¬ 
nal  values  for  k  and  e  are  k(i+lj)  =  and  t(i+I,j)  =  as  explained  in 
i^pendix  B.  External  values  of  quantities  other  than  the  transport  variables 
(such  as  viscosity)  are  provided  by  extrapolation;  e.g. 


v(i+lj)  =  2v(ij)  -  v(i-lj)  (E121) 

The  discretization  schemes  used  for  the  advection  terms  and  for  the  cell- 
centered  first-derivatives  do  not  affect  the  diffusion  term  vV  which  is 

always  discretized  in  the  manner  indicated  by  Equations  E27-E66. 


Radiation  Boundary  Condition 

STREMR  recognizes  two  distinct  types  of  inflow/outflow  boundaries 
(FLUX  and  OPEN),  both  of  which  allow  fluid  to  enter  or  leave  the  grid.  The 
volumetric  flux  components  (U,V)  are  fixed  and  unchanging  for  the  boundary 
faces  of  a  FLUX  cell.  This  is  not  the  case  for  an  OPEN  cell,  whose  boundary 
fluxes  are  free  to  change  in  response  to  the  flow  inside  the  grid. 

OPEN  boundaries  are  not  physical  boundaries.  They  are  frontiers  beyond 
which  the  flow  is  unknown  and  through  which  the  flow  passes  as  if  no  bound¬ 
ary  were  present  at  all.  In  principle,  their  only  property  is  transparency,  and 
they  should  absorb  outward-moving  disturbances  without  producing  any  reflec¬ 
tions.  Orlanski  (1976)  has  proposed  a  discrete  version  of  the  Sommerfeld 
radiation  condition  that  makes  computational  boundaries  effectively 
transparent 

STTREMR  uses  the  radiation  condition  only  for  the  velocity  components 
(«,v)  normal  to  OPEN  boundary  faces.  The  equation  for  the  radiation  of  u 
through  an  east  or  west  face  is 


Mj  +  =  0  (E122) 

and  for  the  radiation  of  v  through  a  north  or  south  face 

V,  +  C2V^  =  0  (E123) 


where 

Cj  =  propagation  velocity  for  discrete  changes  in  u 
C2  =  propagation  velocity  for  discrete  changes  in  v 
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The  propagation  velocities  have  to  be  obtained  from  the  computed  flow  in  the 
FIELD  cells  next  to  the  OPEN  cell.  For  example,  let  cel!  (i,j)  be  an  OPEN 
cell  whose  east  face  is  a  boundary  face,  and  let  the  superscript  m  denote  the 
elapsed  number  of  discrete  time-steps  (At)  at  the  beginning  of  the 
MacCormack  predictor  phase.  The  propagation  velocity  for  u  is  then  taken  to 
be 


(E124) 


The  superscript  m-1/2  means  that  the  quantity  in  brackets  is  evaluated  halfway 
between  time-steps  m  and  m-1,  and  the  subscript  i-I  means  that  it  is  evaluated 
at  the  center  of  cell  (i-I,J)-  Using  central-difference  approximations  in  space 
and  time,  the  discrete  equation  for  Cj  in  the  predictor  phase  is 


CjA/  J) -u^~^(i-lj)  +ii”(i-2J) -u^~^(i-2j) 


(E125) 


Equation  E125  defines  the  radiation  Courant  number 

C  =  ^  (E126) 

Since  the  object  is  for  the  east  face  of  cell  (i,j)  to  transmit  information  only  to 
the  right,  C  is  set  equal  to  zero  if  the  right-hand  side  (RHS)  of  Equation  E125 
is  negative;  i.e. 


C  =  Max  [  0 ,  RHS(EI2S)  ]  (^*27) 

To  avoid  numerical  instability  that  might  be  caused  by  C  >  7,  STREMR 
supplements  Equation  E127  with  a  second  constraint. 


C  =  Afw  [  1 ,  RHS(E127)  ]  (^^28) 

Equations  E127  and  E128  keep  the  radiation  Courant  number  between  zero 
and  unity,  and  the  value  for  u  at  the  end  of  the  predictor  phase  becomes 


=  (1  -  O"£0V)  +  CQ”(i-lj) 


(E129) 
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For  the  conector  phase,  the  deOnition  of  C*  is 


J) 

*u^i-2j)  -«^i-l  j)  -£E^i-l  J) 


(E130) 


and  C*  is  likewise  constrained  to  lie  between  zero  and  unity.  In  keq)ing  with 
the  logic  of  the  MacCoimack  scheme,  the  value  for  u  at  the  end  of  the 
corrector  phase  is  given  by 


j«+l 

“£ 


«£(»>/)  +(1  -C  *)  +c  *  j) 


(E131) 


In  both  the  predictor  and  corrector  phases,  the  individual  fluxes  have  to  be 
adjusted  so  that  the  total  volumetric  flux  is  constant  through  each  continuous 
segment  of  OPEN  faces.  This  adjustment  is  necessary  for  maintaining  a 
constant  flow  rate  through  the  grid. 


Sidewall  Shear  Stress 

STREMR  assigns  a  NOSLIP  designation  by  default  to  all  non-OUT  cells 
that  touch  the  boundaries  of  the  grid,  except  for  those  cells  specified  otherwise 
by  the  user.  The  shear  stress  for  NOSLIP  boundary  faces  is  calculated  either 
from  the  near-wall  vorticity  (turbulent  flow)  or  from  a  true  no-slip  condition 
(laminar  flow).  This  reinstates  the  force  that  was  omitted  from  the  viscous 
diffusion  term  vV  //iVm/  by  the  assumption  that  «  Vu  =  0  (Equations  E45- 
E55).  It  is  this  force  that  distinguishes  a  NOSUP  boundary  face  from  a  SLIP 
boundary  face,  for  which  the  condition  =  0  means  there  is  no  shear 
stress  unless  there  is  curvature. 

In  the  case  of  turbulent  flow,  the  near-wall  vorticity  is  calculated  from  the 
tangential  velocity  at  the  center  of  the  NOSLIP  cell  adjacent  to  the  wall.  Sup¬ 
pose  cell  (i,j)  is  a  NOSUP  cell,  and  cell  (y-I)  is  an  OUT  cell.  The  south  face 
of  cell  (y)  is  then  a  NOSUP  boundary  face,  onto  which  the  tangential  velocity 
Ujg  has  to  be  projected  from  the  cell-centered  velocity  u.  The  unit  vector  £ 
tangent  to  the  (constant-q)  boundary  is 


t  = 


'I 


2  2 


(E132) 


with  the  coordinate  derivatives  evaluated  on  the  south  face;  i.e. 
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(E133) 


=  yiiJ-1)  -  (E134) 

The  tangential  velocity  (vector)  is 

Eb  *  (H’D  £  (E135) 

Thus,  the  x-  and  y-components  of  the  tangential  velocity  become 


x^[x^u  *y^v] 

2  2 
^  ">'1 


(E136) 


^  y^[x^u  +>’|v] 


2  2 


(E137) 


Where  u  and  v  are  the  cell-centered  velocity  components  u(r,s)  and  v(r,s) 
given  by  Equations  ElOS  and  E106. 


Assuming  that  the  tangential  velocity  is  proportional  to  the  1/7  power  of  the 
normal  distance  5  from  the  wall,  then  the  absolute  value  of  the  near-waU 
vorticity  oj  is 


|co| 


*B 


(E138) 


STREMR  approximates  the  resisting  shear  stress  Xp  with 


=  pC£,v-4 


*B 


''B 


76 


(E139) 


where,  for  this  case. 


6  = 


^  (y^f 


(E140) 
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The  resultant  shear  force  has  a  direction  opposite  that  of  the  tangential  velocity 
vector  Ug,  and  the  coefficient  Cj)  (DRAG  in  STREMR)  has  a  default  value  of 
unity.  The  user  can  raise  or  lower  to  increase  or  decrease  Xj^  if  necessary. 


Laminar  No-Slip  Condition 

STREMR  uses  Equation  E139  to  calculate  the  sidewall  ^ear  stress  only  if 
the  turbulence  tiKrdel  is  activated  (KETURB  =  ’YES’).  Otherwise 
(KETURB  =  ’NO’),  the  code  imposes  a  visa>us  no-slip  condition  in  the 
following  manner  for  laminar  flow. 

Suppose  cell  (i,f)  is  a  NOSLIP  cell,  and  celi  (y-i)  is  an  OUT  cell.  The 
south  face  of  cell  (i,f)  is  then  a  NOSLIP  boimdary  face,  on  which  the  velocity 
is  to  be  identically  zero.  A  Taylor-series  expansion  of  the  velocity  for  cell 
gives  the  velocity  (w^v^)  on  the  south  face  of  cell  (i,/); 


-•■•••  =  0  (E141) 

with  a  similar  expansion  for  v^.  Note  that  the  south  face  of  NOSLIP  celi  (i,f) 
is  also  the  north  face  of  OUT  cell  (y-i).  After  introducing  finite-difference 
approximations  in  Equation  E141  for  and 


“n 


«  ~3«(y-l)  4«(iJ)  --  ujij*!) 

2&x\ 


..  _  -  Mij)  * 

^  - 1? - 


one  then  obtains  an  extrapolated  approximation  for  i.e. 


(E142) 


(E143) 


a(y-l)  -  Lu(ij+1)  -  2u{ij)  (E144) 

with  a  similar  extrapolation  for  v(i,j-l).  On  the  south  face  of  cell  (y),  the  |- 
and  Ti-derivatives  of  u  now  become 


s 

“I 


=  0 


(E145) 
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(E146) 


%  *  3u(ij)  - 

with  similar  expressions  for  the  and  ri-derivatives  of  v.  The  |-derivative  is 
zero  because  the  vetocity  is  identically  zero  on  the  boundary,  which  is  tangent 
to  the  |-direction. 

Equations  E14S  and  E146  are  now  used  to  calculate  the  viscous  flux  of  u 
through  the  south  face  of  cell  (ij): 

^  “/  -y^  »x 

where  the  x-  and  y-derivatives  are  given  by 


(E148) 


s 


s 


with  similar  equations  for  the  viscous  flux  of  v. 


(E149) 


E24 
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Interpolation  of  Input  Variables 

If  INTER?  =  ’YES*  in  namelist  BEGIN,  STREMR  uses  interpolation  to 
create  smooth  distributions  of  depth  (or  elevation)  and  Manning’s  coefncient. 
Since  the  interpolation  procedure  is  the  same  in  all  cases,  let  the  generic 
function  tp  represent  the  variable  to  be  interpolated. 

In  boundary  cells,  the  default  value  (^>ecifled  in  the  general  input)  is  used 
for  Ip,  except  where  changed  by  subsequent  (section,  line,  or  random)  namelist 
input.  In  FIELD  cells,  however,  the  default  value  is  ignored;  i.e.,  if  no  ip- 
v^ue  is  assigned  to  FTELD  cell  by  the  namelists  for  section,  line,  or 
random  input,  then  will  be  interpolated  from  values  in  neighboring  cells. 
Otherwise,  if  a  value  for  tp  has  been  assigned  to  FIELD  cell  that  value 
will  be  held  flxed. 

In  FIELD  cells  for  which  \p  has  not  been  specified  by  namelist  input,  the 
interpolated  values  of  tp  must  satisfy  the  Laplace  equation 


JV\>  =  0 

whose  discretized  left-hand  side  is  given  by  Equation  E31.  Note  that  for  inter¬ 
polation,  the  A-coeffleients  are  those  defined  by  Equations  E32-E40,  with  h 
equal  to  unity. 

Initial  Flow 

STREMR  uses  input  velocities  to  calculate  volumetric  fluxes  (Equations  D9 
and  DIO)  through  the  boundary  faces  of  all  OPEN  cells  and  FLUX  cells. 

These  fluxes  are  then  adjusted  so  that  the  net  inflow  and  outflow  are  equal.  If 
VGUESS  =  ’YES’  in  namelist  BEGIN,  the  input  velocities  are  also  us^  to 
calculate  tentative  nonzero  values  for  the  remaining  fluxes  {U\V').  Otherwise, 
if  VGUESS  =  ’NO’  (default),  the  remaining  fluxes  {U’,V’)  are  tentatively  set 
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to  zero.  In  either  case,  this  may  violate  the  continuity  equation  for  one  or 
more  of  the  grid  cells;  i.e. 

u'  +v'^0  (P2) 

STREMR  converts  the  tentative  fluxes  to  mass-conserving  fluxes  by  adding  to 
them  the  gradient  of  a  scalar  potential  so  that 


for  which  <ti  must  satisfy  a  Poisson  equation 

/  V<AV<|))  =  (F5) 

Equations  F3  and  F4  define  the  initial  flow,  from  which  the  later  flow  must 
evolve. 

If  VGUESS  =  ’NO’,  the  flow  is  initially  irrotational,  which  means  that  it  is 
free  of  vorticity  (circulation).  At  later  times  it  may  have  changed  consider¬ 
ably,  however,  due  to  the  combined  effects  of  friction,  inflow,  turbulence, 
secondary  flow,  and  possibly  truncation  error.  The  flow  may  approach  a 
steady  ctate  for  some  boundary  configurations  and  initial  conditions;  but  it  may 
remain  (or  become)  quite  unsteady  for  others,  perhaps  exhibiting  periodic 
behavior  (as  with  vortex  shedding). 

Turbulence  and  Secondary  Flow 

Appendix  B  presents  the  Cartesian  form  of  the  governing  equations  fB2  and 
B3)  for  the  k-e  turbulence  model.  With  the  advection  temis  expressed  in 
curvilinear  form,  the  semi-discrete  equations  for  k  and  e  are 

^  =  vF  -  e  ♦  or^h  WivhVk) 

At  hJ  k  \  ^ 


F2 
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^  *  %1  .  irc.vr  -  C,.l  .  a-'*-' V<v*V.) 

M  hJ  *>-1  2  j  e 

Appendix  C  likewise  presents  the  Cartesian  form  of  the  governing  equation 
(C18)  for  the  secondary  flow.  With  the  advection  term  expressed  in  curvi¬ 
linear  form,  the  semi-discrete  equation  for  Q  is 


^  I  ^  r(1.9/.2/r2)  *  ^  ^ 


(F8) 


^V<hvVn) 


Each  of  Equations  F6-F8  can  be  expressed  as  a  generic  advection-diffusion 
equation  with  terms  added  for  production  and  dissipation  (damping): 


^  =  p  -  D  *  1  V<hVq))  +  VvVri) 

At  hJ  h 

where  P  is  the  production  term  and  D  is  the  damping  term. 

To  calculate  Atp,  STREMR  uses  the  Euler  upwind  scheme  for  advection 
(Equations  E78-E82),  with  cell-centered  discretization  for  the  diffusion  term 
(Equation  E31)  and  for  the  gradient  terms  (Equations  El  16  and  El  17).  The 
increment  Arp  is  then  given  explicitly  by 


Aip=Ar 


P-D  -h  'h  +V\p^)  +.lv<hV\p)  ♦VvVq) 


(FIO) 


The  right-hand  side  of  Equation  FIO  consists  entirely  of  old  information 
at  time  t.  The  new  value  of  tp  at  time  r  +  A/  is 


tp  ■  •»p  +  A\p  0*1^) 

and  the  symbol  •  means  that  the  sum  on  the  right  replaces  the  previous  value 
of  the  quantity  on  the  left  This  is  the  manner  in  which  k~,  e,  and  Q  are 
advanced  from  one  time-step  to  the  next. 


Primary  Flow 

With  the  advection  term  expressed  in  curvilinear  form,  but  with  all  forces 
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except  the  pressure  gradient  still  represented  by  the  vector  F,  the  depth- 
averaged  momentum  equation  (Al)  is 


du 

IT 


+  h 


-  F  -  p'^V/r 


(FI  2) 


Let  u(r,s)  be  a  velocity  vector  whose  components  are  defined  in  terms  of  the 
shiL  indices  (r,^)  by  Equations  El05  and  E106;  and  let  U(r)  and  V(s)  be  flux 
components  similarly  defined  by  Equations  E97  and  E98.  With  these  substitu¬ 
tions,  and  with  the  pressure  gradient  omitted,  the  momentum  equation  takes  the 
semi-discrete  ‘‘.irm 


Au(r,s)  -  At 


F{r,s)-h 


U{r) 


du{r,s) 


■V{S) 


3w(r,i) 


(F13) 


STREMR  begins  the  predictor  phase  of  the  MacCormack  scheme  at  time  t 
with  the  fluxes  U  and  V,  and  with  the  index  pair  (r,^)  chosen  from  one  of  four 
possible  combinations;  (0,0),  (1,0),  (0,1),  or  (1,1).  These  regulate  not  only  the 
difference  direction  for  advcction  (Equation  E84),  b  also  the  cell  faces  from 
which  the  lluxes  arc  taken  to  define  the  cell-centered  velocities  (Equations 
E105  and  E106).  The  increment  Aufr.s)  subsequently  determines  the  flux 
increments  AU(r)  and  ATfs)  through  Equations  E108  and  E109,  which  arc 
added  to  the  existing  lluxes  to  obtain 


U\r)  =  U{r)  AU{r) 

(F14) 

V(s}  =  l/(.v)  +  AV(s) 

(F15) 

These  lluxes  do  not  conserve  mass,  because  the  pressure  gradient  was  omitted 
from  Equation  FI3.  Thus,  the  next  step  is  to  add  the  gradient  of  a  scalar 
potential  Vip  (Equations  F3  and  F4),  which  must  satisfy  Equation  F5,  and 
which  is  related  to  the  pressure  by 

4,  - 

p 

(F16) 

This  final  step  produces  the  mass-conserving 
the  nd  of  the  MacCormack  predictor  phase. 

(luxes  U  and  V*,  and  it  marks 
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The  corrector  phase  begins  with  the  fluxes  U*  and  V*,  and  it  repeats  the 
steps  of  the  predictor  phase  with  r  =  1  -  r  and  s  =  1  -  s,  which  reverses  the 
diffl  'ence  directions  for  advection.  In  this  phase,  however,  the  nonconserva¬ 
tive  fluxes  (analogous  to  Equations  F14  and  FIS)  are  defined  by 

ir(r*)  =  l[f/(r*)  +  U\r*)  *  At/ >*)]  (F17) 

Vis*)  =  l[v(s*)  +  V(s’)  >  AV*(s*)]  (F18) 

In  the  final  step  of  the  conector  phase,  the  gradient  of  a  scalar  potential  V(|>* 
is  added  (in  the  manner  of  Equations  F3  and  F4)  to  the  nonconservative  fluxes 
given  by  Equations  F17  and  F18.  This  produces  the  mass-conserving  fluxes  at 
time  t  +  At. 

The  potential  <t>*  must  also  satisfy  Equation  FS,  but  it  is  related  to  the 
pressure  p  for  the  corrector  phase  by 


4>*  =  (F19) 

2p 

Qose  inspection  of  Ecjuations  F17  and  F18  reveals  that  the  pressure  gradient 
needed  to  conect  (/(r  )  and  V(s  )  acts  for  only  half  a  time-step. 

The  shift  indices  influence  the  forces  concealed  in  the  vector  FJr,s)  only 
insofar  as  they  control  the  values  of  the  cell-centered  velocity  components 
(Equations  E105  and  E106)  and  the  difference  directions  for  cell-centered 
gradients  (Equations  El  18  and  El  19).  Otherwise,  they  have  no  effect  on 
second  derivatives. 


Variable  Time-Step 

The  MacCormack  scheme  and  the  Euler  upwind  scheme  are  both  explicit 
algorithms.  They  use  only  the  existing  values  to  calculate  new  values  of  the 
flow  variables,  and  this  can  lead  to  trouble  if  the  increments  are  too  big.  Con¬ 
sider,  for  example,  the  differential  equation 

=  0  (F20) 

The  exact  solution  to  Equation  F20  is 
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F5 


'KO  =  'KO)  e 


(F21) 


-}j 

where  is  the  initial  value  of  and  X  is  a  positive  constant  Note  that  if 
the  initial  value  '\\f(0)  is  positive,  then  ^t)  remains  positive  forever.  Now 


consider  the  discrete  version  of  Equation  F21, 

Alp  =  -XAf  'q)(r)  (F22) 

Suppose  that  the  following  two  statements  are  true  at  time  t. 

q<0  >  0  (F23) 

XAt  >  1  (F24) 

Then  it  follows  immediately  from  Equation  F22  that 

Atp  <  0  (f^) 

and 

|Atp|  >  q)(r)  (P26) 

which  means  that 

ip(t+Ar)  =  \ij(r)  +  Atp  <  0 


Thus,  the  function  tp,  which  should  have  remained  positive  forever,  has 
become  negative  in  a  single  time-step.  If  one  proceeds  in  the  same  fashion 
through  another  time-step,  then  it  turns  out  that 

tp(^+2Af)  >  0  (F2®) 

which  means  that  the  discrete  solution  for  op  is  oscillating  about  zero.  The 
amplitude  of  this  numerical  oscillation  depends  on  the  magnitude  of  XA/,  and  it 
leads  to  numerical  instability,  in  which  /xp/  grows  without  bound. 

A  similar  problem  can  arise  with  the  explicit  algorithms  in  STREMR.  This 
is  evident  if  one  writes  the  discretized  governing  equation  for  any  flow 
variable  (except  pressure)  in  the  form 


F6 
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(F29) 


+  other  terms 
ht 

where  ^(hi)  is  the  sum  of  the  absolute  values  of  coefficients  that  multiply 

Disregarding  the  effects  of  the  other  terms  in  Equation  F29,  the  time- 
step  must  satisfy  the  following  criterion  if  oscillation  and  instability  are  to  be 
avoided; 


Ar  < 


1 

Kij) 


(F30) 


Inequality  F30  gives  an  estimate  of  the  maximum  allowable  time-step  for  a 
given  cell  The  cell  with  the  largest  value  of  Mh})  ^en  determines  the 
maximum  allowable  time  step  for  the  whole  grid: 


A/, 


max 


Mij) 


max 


(F31) 


If  TIMER  =  ’YES’  in  namelist  BEGIN,  STREMR  uses  Equation  F31,  with 
MKj)  obtained  from  the  momentum  equation,  to  set  the  time-stq>  size  for  the 
MacCormack  scheme  and  the  Euler  upwind  scheme. 
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